@brightspace-ui/core 3.67.0 → 3.68.0

package/components/button/button-toggle.js

@@ -2,6 +2,7 @@ import { css, html, LitElement } from 'lit';
 
 /**
  * A button container component for button toggles.
+ * @fires d2l-button-toggle-before-change - Dispatched before pressed state is updated. Can be canceled to allow the consumer to handle toggling pressed state. This is useful if something needs to happen prior to the pressed state being toggled.
  */
 class ButtonToggle extends LitElement {
 
@@ -79,9 +80,16 @@ class ButtonToggle extends LitElement {
 	}
 
 	async _handleClick(pressed) {
-		this.pressed = pressed;
-		await this.updateComplete;
-		this.focus();
+		const beforeToggleEvent = new CustomEvent('d2l-button-toggle-before-change', {
+			detail: {
+				update: (newPressed) => this._updatePressedState(newPressed)
+			},
+			cancelable: true
+		});
+		this.dispatchEvent(beforeToggleEvent);
+		if (beforeToggleEvent.defaultPrevented) return;
+
+		this._updatePressedState(pressed);
 	}
 
 	_handleNotPressedClick() {
@@ -92,6 +100,12 @@ class ButtonToggle extends LitElement {
 		this._handleClick(false);
 	}
 
+	async _updatePressedState(newPressed) {
+		this.pressed = newPressed;
+		await this.updateComplete;
+		this.focus();
+	}
+
 }
 
 customElements.define('d2l-button-toggle', ButtonToggle);

package/components/button/demo/button-toggle.html

@@ -54,6 +54,26 @@
 				</template>
 			</d2l-demo-snippet>
 
+			<h2>Toggle Button (with consumer specifying when to toggle)</h2>
+
+			<d2l-demo-snippet>
+				<template>
+					<d2l-button-toggle id="toggle-button-icon-promise-delay">
+						<d2l-button-icon slot="not-pressed" icon="tier1:pin-hollow" text="Unpinned, click to pin."></d2l-button-icon>
+						<d2l-button-icon slot="pressed" icon="tier1:pin-filled" text="Pinned, click to unpin."></d2l-button-icon>
+					</d2l-button-toggle>
+					<script>
+						document.querySelector('#toggle-button-icon-promise-delay').addEventListener('d2l-button-toggle-before-change', e => {
+							e.preventDefault();
+							setTimeout(() => {
+								e.detail.update(!e.target.pressed);
+							}, 2000);
+						});
+						document.querySelector('#toggle-button-icon-promise-delay').addEventListener('d2l-button-toggle-change', e => console.log(e));
+					</script>
+				</template>
+			</d2l-demo-snippet>
+
 		</d2l-demo-page>
 
 	</body>

package/custom-elements.json

@@ -739,6 +739,10 @@
         }
       ],
       "events": [
+        {
+          "name": "d2l-button-toggle-before-change",
+          "description": "Dispatched before pressed state is updated. Can be canceled to allow the consumer to handle toggling pressed state. This is useful if something needs to happen prior to the pressed state being toggled."
+        },
         {
           "name": "d2l-button-toggle-change",
           "description": "Dispatched when the pressed state changes"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightspace-ui/core",
-  "version": "3.67.0",
+  "version": "3.68.0",
   "description": "A collection of accessible, free, open-source web components for building Brightspace applications",
   "type": "module",
   "repository": "https://github.com/BrightspaceUI/core.git",