@brightspace-ui/core 3.67.0 → 3.68.1

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/lang/fr.js

@@ -117,7 +117,7 @@ export default {
 	"components.selection-controls.label": "Actions à sélectionner",
 	"components.switch.visible": "Visible",
 	"components.switch.visibleWithPeriod": "Visible.",
-	"components.switch.hidden": "Masqué(e)",
+	"components.switch.hidden": "Masqué",
 	"components.switch.conditions": "Les conditions doivent être remplies",
 	"components.table-col-sort-button.addSortOrder": "Sélectionner pour ajouter un ordre de tri",
 	"components.table-col-sort-button.changeSortOrder": "Sélectionner pour modifier l'ordre de tri",

package/lang/hi.js

@@ -43,7 +43,7 @@ export default {
 	"components.form-element.input.number.rangeUnderflow": "{minExclusive, select, true {संख्या {min} से ज़्यादा होनी चाहिए.} other {संख्या {min} से ज़्यादा या उसके बराबर होनी चाहिए.}}",
 	"components.form-element.input.text.tooShort": "{label} कम से कम {minlength} वर्णों का होना चाहिए",
 	"components.form-element.input.url.typeMismatch": "URL मान्य नहीं है",
-	"components.form-element.valueMissing": "{label} आवश्यक है",
+	"components.form-element.valueMissing": "{label} ज़रूरी है",
 	"components.form-error-summary.errorSummary": "{count, plural, one {आपके द्वारा सबमिट की गई जानकारी में {count} त्रुटियाँ पाई गईं} other {आपके द्वारा सबमिट की गई जानकारी में {count} त्रुटियाँ पाई गईं}}",
 	"components.form-error-summary.text": "त्रुटि विवरण टॉगल करें",
 	"components.input-color.backgroundColor": "पृष्ठभूमि का रंग",

package/package.json

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