@brightspace-ui/core 1.180.2 → 1.182.0

package/custom-elements.json

@@ -3085,7 +3085,13 @@
     {
       "name": "d2l-html-block",
       "path": "./components/html-block/html-block.js",
-      "description": "A component for displaying user-authored HTML."
+      "description": "A component for displaying user-authored HTML.",
+      "slots": [
+        {
+          "name": "",
+          "description": "Provide an html template that contains your user-authored HTML"
+        }
+      ]
     },
     {
       "name": "d2l-icon-demo-color-override",
@@ -5834,7 +5840,7 @@
       "attributes": [
         {
           "name": "slim",
-          "description": "Whether to render a header with reduced whitespace.",
+          "description": "Whether to render a header with reduced whitespace",
           "type": "boolean",
           "default": "false"
         }
@@ -5843,7 +5849,7 @@
         {
           "name": "slim",
           "attribute": "slim",
-          "description": "Whether to render a header with reduced whitespace.",
+          "description": "Whether to render a header with reduced whitespace",
           "type": "boolean",
           "default": "false"
         }
@@ -5868,25 +5874,22 @@
         },
         {
           "name": "draggable",
-          "description": "Whether the item is draggable",
+          "description": "**Drag & drop:** Whether the item is draggable",
           "type": "boolean"
         },
         {
           "name": "drag-handle-text",
+          "description": "**Drag & drop:** The drag-handle label for assistive technology. If implementing drag & drop, you should change this to dynamically announce what the drag-handle is moving for assistive technology in keyboard mode.",
           "type": "string"
         },
         {
           "name": "drop-text",
+          "description": "**Drag & drop:** Text to drag and drop",
           "type": "string"
         },
-        {
-          "name": "dragging",
-          "type": "boolean",
-          "default": "false"
-        },
         {
           "name": "disabled",
-          "description": "Disables the input",
+          "description": "**Selection:** Disables the input",
           "type": "boolean"
         },
         {
@@ -5896,12 +5899,12 @@
         },
         {
           "name": "selectable",
-          "description": "Indicates a input should be rendered for selecting the item",
+          "description": "**Selection:** Indicates a input should be rendered for selecting the item",
           "type": "boolean"
         },
         {
           "name": "selected",
-          "description": "Whether the item is selected",
+          "description": "**Selection:** Whether the item is selected",
           "type": "boolean"
         },
         {
@@ -5912,10 +5915,12 @@
         },
         {
           "name": "labelled-by",
+          "description": "The id of element that provides the label for this element",
           "type": "string"
         },
         {
           "name": "label",
+          "description": "Explicitly defined label used to provide context for accessibility",
           "type": "string"
         }
       ],
@@ -5937,29 +5942,25 @@
         {
           "name": "draggable",
           "attribute": "draggable",
-          "description": "Whether the item is draggable",
+          "description": "**Drag & drop:** Whether the item is draggable",
           "type": "boolean"
         },
         {
           "name": "dragHandleText",
           "attribute": "drag-handle-text",
+          "description": "**Drag & drop:** The drag-handle label for assistive technology. If implementing drag & drop, you should change this to dynamically announce what the drag-handle is moving for assistive technology in keyboard mode.",
           "type": "string"
         },
         {
           "name": "dropText",
           "attribute": "drop-text",
+          "description": "**Drag & drop:** Text to drag and drop",
           "type": "string"
         },
-        {
-          "name": "dragging",
-          "attribute": "dragging",
-          "type": "boolean",
-          "default": "false"
-        },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "Disables the input",
+          "description": "**Selection:** Disables the input",
           "type": "boolean"
         },
         {
@@ -5971,19 +5972,17 @@
         {
           "name": "selectable",
           "attribute": "selectable",
-          "description": "Indicates a input should be rendered for selecting the item",
+          "description": "**Selection:** Indicates a input should be rendered for selecting the item",
           "type": "boolean"
         },
         {
           "name": "selected",
           "attribute": "selected",
-          "description": "Whether the item is selected",
+          "description": "**Selection:** Whether the item is selected",
           "type": "boolean"
         },
         {
-          "name": "selectionInfo",
-          "description": "Private. The selection info (set by the selection component).",
-          "type": "object"
+          "name": "selectionInfo"
         },
         {
           "name": "skeleton",
@@ -5995,25 +5994,28 @@
         {
           "name": "labelledBy",
           "attribute": "labelled-by",
+          "description": "The id of element that provides the label for this element",
           "type": "string"
         },
         {
           "name": "label",
           "attribute": "label",
+          "description": "Explicitly defined label used to provide context for accessibility",
           "type": "string"
         }
       ],
       "events": [
         {
           "name": "d2l-list-item-button-click",
-          "description": "Dispatched when the component item is clicked"
+          "description": "Dispatched when the item's primary button action is clicked"
         },
         {
-          "name": "d2l-list-item-selected",
-          "description": "Dispatched when the component item is selected"
+          "name": "d2l-list-item-position-change",
+          "description": "Dispatched when a draggable list item's position changes in the list. See [Event Details: d2l-list-item-position-change](#event-details%3A-d2l-list-item-position-change)."
         },
         {
-          "name": "d2l-list-item-position-change"
+          "name": "d2l-list-item-selected",
+          "description": "Dispatched when the component item is selected"
         }
       ],
       "slots": [
@@ -6056,14 +6058,17 @@
       "attributes": [
         {
           "name": "keyboard-text-info",
+          "description": "Additional context information for accessibility",
           "type": "object"
         },
         {
           "name": "text",
+          "description": "The drag-handle label for assistive technology",
           "type": "string"
         },
         {
           "name": "disabled",
+          "description": "Disables the handle",
           "type": "boolean",
           "default": "false"
         }
@@ -6072,23 +6077,27 @@
         {
           "name": "keyboardTextInfo",
           "attribute": "keyboard-text-info",
+          "description": "Additional context information for accessibility",
           "type": "object"
         },
         {
           "name": "text",
           "attribute": "text",
+          "description": "The drag-handle label for assistive technology",
           "type": "string"
         },
         {
           "name": "disabled",
           "attribute": "disabled",
+          "description": "Disables the handle",
           "type": "boolean",
           "default": "false"
         }
       ],
       "events": [
         {
-          "name": "d2l-list-item-drag-handle-action"
+          "name": "d2l-list-item-drag-handle-action",
+          "description": "Dispatched when an action performed on the drag handle"
         }
       ]
     },
@@ -6175,25 +6184,22 @@
         },
         {
           "name": "draggable",
-          "description": "Whether the item is draggable",
+          "description": "**Drag & drop:** Whether the item is draggable",
           "type": "boolean"
         },
         {
           "name": "drag-handle-text",
+          "description": "**Drag & drop:** The drag-handle label for assistive technology. If implementing drag & drop, you should change this to dynamically announce what the drag-handle is moving for assistive technology in keyboard mode.",
           "type": "string"
         },
         {
           "name": "drop-text",
+          "description": "**Drag & drop:** Text to drag and drop",
           "type": "string"
         },
-        {
-          "name": "dragging",
-          "type": "boolean",
-          "default": "false"
-        },
         {
           "name": "disabled",
-          "description": "Disables the input",
+          "description": "**Selection:** Disables the input",
           "type": "boolean"
         },
         {
@@ -6203,12 +6209,12 @@
         },
         {
           "name": "selectable",
-          "description": "Indicates a input should be rendered for selecting the item",
+          "description": "**Selection:** Indicates a input should be rendered for selecting the item",
           "type": "boolean"
         },
         {
           "name": "selected",
-          "description": "Whether the item is selected",
+          "description": "**Selection:** Whether the item is selected",
           "type": "boolean"
         },
         {
@@ -6219,10 +6225,12 @@
         },
         {
           "name": "labelled-by",
+          "description": "The id of element that provides the label for this element",
           "type": "string"
         },
         {
           "name": "label",
+          "description": "Explicitly defined label used to provide context for accessibility",
           "type": "string"
         }
       ],
@@ -6256,29 +6264,25 @@
         {
           "name": "draggable",
           "attribute": "draggable",
-          "description": "Whether the item is draggable",
+          "description": "**Drag & drop:** Whether the item is draggable",
           "type": "boolean"
         },
         {
           "name": "dragHandleText",
           "attribute": "drag-handle-text",
+          "description": "**Drag & drop:** The drag-handle label for assistive technology. If implementing drag & drop, you should change this to dynamically announce what the drag-handle is moving for assistive technology in keyboard mode.",
           "type": "string"
         },
         {
           "name": "dropText",
           "attribute": "drop-text",
+          "description": "**Drag & drop:** Text to drag and drop",
           "type": "string"
         },
-        {
-          "name": "dragging",
-          "attribute": "dragging",
-          "type": "boolean",
-          "default": "false"
-        },
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": "Disables the input",
+          "description": "**Selection:** Disables the input",
           "type": "boolean"
         },
         {
@@ -6290,19 +6294,17 @@
         {
           "name": "selectable",
           "attribute": "selectable",
-          "description": "Indicates a input should be rendered for selecting the item",
+          "description": "**Selection:** Indicates a input should be rendered for selecting the item",
           "type": "boolean"
         },
         {
           "name": "selected",
           "attribute": "selected",
-          "description": "Whether the item is selected",
+          "description": "**Selection:** Whether the item is selected",
           "type": "boolean"
         },
         {
-          "name": "selectionInfo",
-          "description": "Private. The selection info (set by the selection component).",
-          "type": "object"
+          "name": "selectionInfo"
         },
         {
           "name": "skeleton",
@@ -6314,24 +6316,28 @@
         {
           "name": "labelledBy",
           "attribute": "labelled-by",
+          "description": "The id of element that provides the label for this element",
           "type": "string"
         },
         {
           "name": "label",
           "attribute": "label",
+          "description": "Explicitly defined label used to provide context for accessibility",
           "type": "string"
         }
       ],
       "events": [
         {
-          "name": "d2l-list-item-selected",
-          "description": "Dispatched when the component item is selected"
+          "name": "d2l-list-item-link-click",
+          "description": "Dispatched when the item's primary link action is clicked"
         },
         {
-          "name": "d2l-list-item-link-click"
+          "name": "d2l-list-item-position-change",
+          "description": "Dispatched when a draggable list item's position changes in the list. See [Event Details: d2l-list-item-position-change](#event-details%3A-d2l-list-item-position-change)."
         },
         {
-          "name": "d2l-list-item-position-change"
+          "name": "d2l-list-item-selected",
+          "description": "Dispatched when the component item is selected"
         }
       ],
       "slots": [
@@ -6368,7 +6374,7 @@
         },
         {
           "name": "grid",
-          "description": "Use grid to manage focus with arrow keys",
+          "description": "Use grid to manage focus with arrow keys. See [Accessibility](#accessibility).",
           "type": "boolean",
           "default": "false"
         },
@@ -6397,7 +6403,7 @@
         {
           "name": "grid",
           "attribute": "grid",
-          "description": "Use grid to manage focus with arrow keys",
+          "description": "Use grid to manage focus with arrow keys. See [Accessibility](#accessibility).",
           "type": "boolean",
           "default": "false"
         },
@@ -6418,7 +6424,7 @@
       "slots": [
         {
           "name": "",
-          "description": "List content (e.g., \"listitem\"s)"
+          "description": "List content (e.g., `listitem`s)"
         }
       ]
     },
@@ -7378,7 +7384,7 @@
       "slots": [
         {
           "name": "",
-          "description": "Content to wrap"
+          "description": "User provided content to wrap"
         }
       ]
     },
@@ -7511,10 +7517,12 @@
         },
         {
           "name": "labelled-by",
+          "description": "The id of element that provides the label for this element",
           "type": "string"
         },
         {
           "name": "label",
+          "description": "Explicitly defined label used to provide context for accessibility",
           "type": "string"
         }
       ],
@@ -7554,11 +7562,13 @@
         {
           "name": "labelledBy",
           "attribute": "labelled-by",
+          "description": "The id of element that provides the label for this element",
           "type": "string"
         },
         {
           "name": "label",
           "attribute": "label",
+          "description": "Explicitly defined label used to provide context for accessibility",
           "type": "string"
         }
       ],

package/directives/animate/demo/index.html

@@ -2,10 +2,8 @@
 <html lang="en">
 	<head>
 		<meta name="viewport" content="width=device-width, initial-scale=1.0">
-		<meta http-equiv="X-UA-Compatible" content="ie=edge">
 		<meta charset="UTF-8">
 		<link rel="stylesheet" href="../../../components/demo/styles.css" type="text/css">
-		<script src="/node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>
 		<script type="module">
 			import '../../../components/demo/demo-page.js';
 			import './animate-test.js';

package/helpers/demo/announce.html

@@ -2,10 +2,8 @@
 <html lang="en">
 	<head>
 		<meta name="viewport" content="width=device-width, initial-scale=1.0">
-		<meta http-equiv="X-UA-Compatible" content="ie=edge">
 		<meta charset="UTF-8">
 		<link rel="stylesheet" href="../../components/demo/styles.css" type="text/css">
-		<script src="/node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>
 		<script type="module">
 			import '../../components/demo/demo-page.js';
 			import './announce-test.js';

package/helpers/demo/dismissible.html

@@ -2,10 +2,8 @@
 <html lang="en">
 	<head>
 		<meta name="viewport" content="width=device-width, initial-scale=1.0">
-		<meta http-equiv="X-UA-Compatible" content="ie=edge">
 		<meta charset="UTF-8">
 		<link rel="stylesheet" href="../../components/demo/styles.css" type="text/css">
-		<script src="/node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>
 		<script type="module">
 			import '../../components/demo/demo-page.js';
 			import './dismissible-test.js';

package/helpers/demo/gestures.html

@@ -2,10 +2,8 @@
 <html lang="en">
 	<head>
 		<meta name="viewport" content="width=device-width, initial-scale=1.0">
-		<meta http-equiv="X-UA-Compatible" content="ie=edge">
 		<meta charset="UTF-8">
 		<link rel="stylesheet" href="../../components/demo/styles.css" type="text/css">
-		<script src="/node_modules/@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>
 		<script type="module">
 			import '../../components/demo/demo-page.js';
 		</script>

package/helpers/framed.js

@@ -0,0 +1,41 @@
+let framed;
+
+export async function isFramed() {
+	if (framed !== undefined) return framed;
+
+	if (window.D2L && window.D2L.IsNotAnIframedApp) {
+		framed = false;
+		return framed;
+	}
+
+	try {
+		if (window === window.parent) {
+			framed = false;
+			return framed;
+		}
+	} catch (e) {
+		framed = false;
+		return framed;
+	}
+
+	framed = await Promise.race([
+		new Promise(resolve => {
+			const handleIsFramedResponse = evt => {
+				if (!evt || !evt.data || !evt.data.isFramed === undefined) return;
+				window.removeEventListener('message', handleIsFramedResponse, false);
+				framed = evt.data.isFramed;
+				resolve(framed);
+			};
+
+			window.addEventListener('message', handleIsFramedResponse, false);
+			window.parent.postMessage('isFramedRequest', '*');
+		}),
+		new Promise(resolve => {
+			setTimeout(() => {
+				resolve(false);
+			}, 75);
+		})
+	]);
+
+	return framed;
+}

package/lang/ar.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "لم يتم التحديد.",
 	"components.calendar.selected": "تم التحديد.",
 	"components.calendar.show": "إظهار {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "إغلاق مربع الحوار هذا",
 	"components.dropdown.close": "إغلاق",
+	"components.filter.clear": "مسح",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "يتم تحميل عوامل التصفية",
 	"components.filter.filterCountDescription": "{number, plural, zero {لم يتم تطبيق عوامل تصفية.} one {تم تطبيق عامل تصفية واحد.} other {{number} من عوامل التصفية التي تم تطبيقها.}}",
 	"components.filter.filters": "عوامل التصفية",

package/lang/cy.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "Heb ei Ddewis.",
 	"components.calendar.selected": "Wedi'i Ddewis.",
 	"components.calendar.show": "Dangos {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Cau'r dialog hwn",
 	"components.dropdown.close": "Cau",
+	"components.filter.clear": "Clirio",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Wrthi’n llwytho hidlyddion",
 	"components.filter.filterCountDescription": "{number, plural, zero {Ni chymhwyswyd hidlwyr.} one {1 hidlydd wedi'i gymhwyso.} other {{number} hidlydd wedi'u cymhwyso.}}",
 	"components.filter.filters": "Hidlyddion",

package/lang/da.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "Ikke valgt.",
 	"components.calendar.selected": "Valgt.",
 	"components.calendar.show": "Vis {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Luk denne dialogboks",
 	"components.dropdown.close": "Luk",
+	"components.filter.clear": "Ryd",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Indlæser filtre",
 	"components.filter.filterCountDescription": "{number, plural, zero {Ingen filtre anvendt.} one {1 filter anvendt.} other {{number} filtre anvendt.}}",
 	"components.filter.filters": "Filtre",

package/lang/de.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "Nicht ausgewählt.",
 	"components.calendar.selected": "Ausgewählt.",
 	"components.calendar.show": "{month} anzeigen",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Dieses Dialogfeld schließen",
 	"components.dropdown.close": "Schließen",
+	"components.filter.clear": "Löschen",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Filter werden geladen",
 	"components.filter.filterCountDescription": "{number, plural, zero {Keine Filter angewendet.} one {1 Filter angewendet.} other {{number} Filter angewendet.}}",
 	"components.filter.filters": "Filter",

package/lang/en.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "Not Selected.",
 	"components.calendar.selected": "Selected.",
 	"components.calendar.show": "Show {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Close this dialog",
 	"components.dropdown.close": "Close",
+	"components.filter.clear": "Clear",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Loading filters",
 	"components.filter.filterCountDescription": "{number, plural, zero {No filters applied.} one {1 filter applied.} other {{number} filters applied.}}",
 	"components.filter.filters": "Filters",

package/lang/es-es.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "No seleccionado.",
 	"components.calendar.selected": "Seleccionado.",
 	"components.calendar.show": "Mostrar {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Cerrar este cuadro de diálogo",
 	"components.dropdown.close": "Cerrar",
+	"components.filter.clear": "Borrar",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Cargando filtros",
 	"components.filter.filterCountDescription": "{number, plural, zero {Sin filtros aplicados.} one {1 filtro aplicado.} other {{number} filtros aplicados.}}",
 	"components.filter.filters": "Filtros",

package/lang/es.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "No seleccionado.",
 	"components.calendar.selected": "Seleccionado.",
 	"components.calendar.show": "Mostrar {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Cerrar este cuadro de diálogo",
 	"components.dropdown.close": "Cerrar",
+	"components.filter.clear": "Borrar",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Cargando filtros",
 	"components.filter.filterCountDescription": "{number, plural, zero {Sin filtros aplicados.} one {1 filtro aplicado.} other {{number} filtros aplicados.}}",
 	"components.filter.filters": "Filtros",

package/lang/fr-fr.js

@@ -6,8 +6,14 @@ export default {
 	"components.calendar.notSelected": "Non sélectionné.",
 	"components.calendar.selected": "Sélectionné.",
 	"components.calendar.show": "Afficher {month}",
+	"components.count-badge.plus" : "{number}+",
 	"components.dialog.close": "Fermer cette boîte de dialogue",
 	"components.dropdown.close": "Fermer",
+	"components.filter.clear": "Effacer",
+	"components.filter.clearAnnounce": "Clearing filters for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Clearing filters",
+	"components.filter.clearDescription": "Clear filters for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clear filters",
 	"components.filter.loading": "Chargement des filtres",
 	"components.filter.filterCountDescription": "{number, plural, zero {Aucun filtre appliqué.} one {1 filtre appliqué.} other {{number} filtres appliqués.}}",
 	"components.filter.filters": "Filtres",