@brightspace-ui/core 1.196.2 → 1.197.2

package/custom-elements.json

@@ -327,7 +327,7 @@
       "slots": [
         {
           "name": "",
-          "description": "breadcrumb items"
+          "description": "Breadcrumb items"
         }
       ]
     },
@@ -1486,13 +1486,13 @@
         }
       ],
       "events": [
-        {
-          "name": "d2l-dialog-open",
-          "description": "Dispatched when the dialog is opened"
-        },
         {
           "name": "d2l-dialog-close",
           "description": "Dispatched with the action value when the dialog is closed for any reason"
+        },
+        {
+          "name": "d2l-dialog-open",
+          "description": "Dispatched when the dialog is opened"
         }
       ],
       "slots": [
@@ -1557,13 +1557,13 @@
         }
       ],
       "events": [
-        {
-          "name": "d2l-dialog-open",
-          "description": "Dispatched when the dialog is opened"
-        },
         {
           "name": "d2l-dialog-close",
           "description": "Dispatched with the action value when the dialog is closed for any reason"
+        },
+        {
+          "name": "d2l-dialog-open",
+          "description": "Dispatched when the dialog is opened"
         }
       ],
       "slots": [
@@ -1645,13 +1645,13 @@
         }
       ],
       "events": [
-        {
-          "name": "d2l-dialog-open",
-          "description": "Dispatched when the dialog is opened"
-        },
         {
           "name": "d2l-dialog-close",
           "description": "Dispatched with the action value when the dialog is closed for any reason"
+        },
+        {
+          "name": "d2l-dialog-open",
+          "description": "Dispatched when the dialog is opened"
         }
       ],
       "slots": [
@@ -2041,13 +2041,13 @@
           "name": "d2l-dropdown-close",
           "description": "Dispatched when the dropdown is closed"
         },
-        {
-          "name": "d2l-dropdown-focus-enter",
-          "description": "Dispatched when user focus enters the dropdown content (trap-focus option only)"
-        },
         {
           "name": "d2l-dropdown-position",
           "description": "Dispatched when the dropdown position finishes adjusting"
+        },
+        {
+          "name": "d2l-dropdown-focus-enter",
+          "description": "Dispatched when user focus enters the dropdown content (trap-focus option only)"
         }
       ],
       "slots": [
@@ -2378,13 +2378,13 @@
           "name": "d2l-dropdown-close",
           "description": "Dispatched when the dropdown is closed"
         },
-        {
-          "name": "d2l-dropdown-focus-enter",
-          "description": "Dispatched when user focus enters the dropdown content (trap-focus option only)"
-        },
         {
           "name": "d2l-dropdown-position",
           "description": "Dispatched when the dropdown position finishes adjusting"
+        },
+        {
+          "name": "d2l-dropdown-focus-enter",
+          "description": "Dispatched when user focus enters the dropdown content (trap-focus option only)"
         }
       ],
       "slots": [
@@ -2715,13 +2715,13 @@
           "name": "d2l-dropdown-close",
           "description": "Dispatched when the dropdown is closed"
         },
-        {
-          "name": "d2l-dropdown-focus-enter",
-          "description": "Dispatched when user focus enters the dropdown content (trap-focus option only)"
-        },
         {
           "name": "d2l-dropdown-position",
           "description": "Dispatched when the dropdown position finishes adjusting"
+        },
+        {
+          "name": "d2l-dropdown-focus-enter",
+          "description": "Dispatched when user focus enters the dropdown content (trap-focus option only)"
         }
       ],
       "slots": [
@@ -2961,11 +2961,6 @@
           "default": "\"\""
         }
       ],
-      "events": [
-        {
-          "name": "d2l-filter-dimension-data-change"
-        }
-      ],
       "slots": [
         {
           "name": "",
@@ -3161,13 +3156,13 @@
           "name": "submit",
           "description": "Dispatched when the form is submitted. Cancelling this event will prevent form submission."
         },
-        {
-          "name": "d2l-form-dirty",
-          "description": "Dispatched whenever any form element fires an `input` or `change` event. Can be used to track whether the form is dirty or not."
-        },
         {
           "name": "formdata",
           "description": "Dispatched after the entry list representing the form's data is constructed. This happens when the form is submitted just prior to submission. The form data can be obtained from the `detail`'s `formData` property."
+        },
+        {
+          "name": "d2l-form-dirty",
+          "description": "Dispatched whenever any form element fires an `input` or `change` event. Can be used to track whether the form is dirty or not."
         }
       ],
       "slots": [
@@ -3210,10 +3205,6 @@
         }
       ],
       "events": [
-        {
-          "name": "d2l-form-dirty",
-          "description": "Dispatched whenever any form element fires an `input` or `change` event. Can be used to track whether the form is dirty or not."
-        },
         {
           "name": "d2l-form-invalid",
           "description": "Dispatched when the form fails validation. The error map can be obtained from the `detail`'s `errors` property."
@@ -3221,6 +3212,10 @@
         {
           "name": "d2l-form-submit",
           "description": "Dispatched when the form is submitted. The form data can be obtained from the `detail`'s `formData` property."
+        },
+        {
+          "name": "d2l-form-dirty",
+          "description": "Dispatched whenever any form element fires an `input` or `change` event. Can be used to track whether the form is dirty or not."
         }
       ],
       "slots": [
@@ -3816,7 +3811,7 @@
       "events": [
         {
           "name": "change",
-          "description": "Dispatched when there is a change to selected start date or selected end date. \"start-value\" and \"end-value\" correspond to the selected values and are formatted in ISO 8601 calendar date format (\"YYYY-MM-DD\")."
+          "description": "Dispatched when there is a change to selected start date or selected end date. `start-value` and `end-value` correspond to the selected values and are formatted in ISO 8601 calendar date format (`YYYY-MM-DD`)."
         }
       ]
     },
@@ -4102,7 +4097,7 @@
       "events": [
         {
           "name": "change",
-          "description": "Dispatched when there is a change to selected start date-time or selected end date-time. \"start-value\" and \"end-value\" correspond to the selected values and are formatted in ISO 8601 combined date and time format (\"YYYY-MM-DDTHH:mm:ss.sssZ\")."
+          "description": "Dispatched when there is a change to selected start date-time or selected end date-time. `start-value` and `end-value` correspond to the selected values and are formatted in ISO 8601 combined date and time format (`YYYY-MM-DDTHH:mm:ss.sssZ`)."
         }
       ],
       "slots": [
@@ -4278,10 +4273,7 @@
       "events": [
         {
           "name": "change",
-          "description": "Dispatched when there is a change to selected date or selected time. \"value\" corresponds to the selected value and is formatted in ISO 8601 combined date and time format (\"YYYY-MM-DDTHH:mm:ss.sssZ\")."
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
+          "description": "Dispatched when there is a change to selected date or selected time. `value` corresponds to the selected value and is formatted in ISO 8601 combined date and time format (`YYYY-MM-DDTHH:mm:ss.sssZ`)."
         }
       ]
     },
@@ -4436,10 +4428,7 @@
       "events": [
         {
           "name": "change",
-          "description": "Dispatched when there is a change to selected date. \"value\" corresponds to the selected value and is formatted in ISO 8601 calendar date format (\"YYYY-MM-DD\")."
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
+          "description": "Dispatched when there is a change to selected date. `value` corresponds to the selected value and is formatted in ISO 8601 calendar date format (`YYYY-MM-DD`)."
         }
       ]
     },
@@ -4768,9 +4757,6 @@
         {
           "name": "change",
           "description": "Dispatched when an alteration to the value is committed (typically after focus is lost) by the user. The `value` attribute reflects a JavaScript Number which is parsed from the formatted input value."
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
         }
       ],
       "slots": [
@@ -4958,9 +4944,6 @@
         {
           "name": "change",
           "description": "Dispatched when an alteration to the value is committed (typically after focus is lost) by the user. The `value` attribute reflects a JavaScript Number which is parsed from the formatted input value."
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
         }
       ],
       "slots": [
@@ -5430,9 +5413,6 @@
         {
           "name": "input",
           "description": "Dispatched immediately after changes by the user"
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
         }
       ],
       "slots": [
@@ -5661,9 +5641,6 @@
         {
           "name": "input",
           "description": "Dispatched immediately after changes by the user"
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
         }
       ]
     },
@@ -5880,7 +5857,7 @@
       "events": [
         {
           "name": "change",
-          "description": "Dispatched when there is a change to selected start time or selected end time. \"start-value\" and \"end-value\" correspond to the selected values and are formatted in ISO 8601 calendar time format (\"hh:mm:ss\")."
+          "description": "Dispatched when there is a change to selected start time or selected end time. `start-value` and `end-value` correspond to the selected values and are formatted in ISO 8601 calendar time format (`hh:mm:ss`)."
         }
       ]
     },
@@ -6046,10 +6023,7 @@
       "events": [
         {
           "name": "change",
-          "description": "Dispatched when there is a change to selected time. \"value\" corresponds to the selected value and is formatted in ISO 8601 time format (\"hh:mm:ss\")."
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
+          "description": "Dispatched when there is a change to selected time. `value` corresponds to the selected value and is formatted in ISO 8601 time format (`hh:mm:ss`)."
         }
       ]
     },
@@ -6345,13 +6319,12 @@
       ],
       "events": [
         {
-          "name": "d2l-list-item-position-change"
-        },
-        {
-          "name": "d2l-list-item-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-labelled-mixin-label-elem-change"
+          "name": "d2l-list-item-selected",
+          "description": "Dispatched when the component item is selected"
         }
       ]
     },
@@ -6545,9 +6518,6 @@
         {
           "name": "d2l-list-item-selected",
           "description": "Dispatched when the component item is selected"
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
         }
       ],
       "slots": [
@@ -6877,9 +6847,6 @@
         {
           "name": "d2l-list-item-selected",
           "description": "Dispatched when the component item is selected"
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
         }
       ],
       "slots": [
@@ -6922,7 +6889,7 @@
         },
         {
           "name": "selection-single",
-          "description": "Whether the selection control is limited to single selection.",
+          "description": "Whether the selection control is limited to single selection",
           "type": "boolean",
           "default": "false"
         }
@@ -6952,21 +6919,19 @@
         {
           "name": "selectionSingle",
           "attribute": "selection-single",
-          "description": "Whether the selection control is limited to single selection.",
+          "description": "Whether the selection control is limited to single selection",
           "type": "boolean",
           "default": "false"
         }
       ],
       "events": [
         {
-          "name": "d2l-list-selection-change",
-          "description": "Dispatched when the selection state changes"
-        },
-        {
-          "name": "d2l-list-selection-changes"
+          "name": "d2l-list-selection-changes",
+          "description": "Dispatched once for a set of selection state changes (ex. select-all); event detail includes an array of objects where each object contains the `key` and `selected` state for each changed item"
         },
         {
-          "name": "d2l-selection-provider-connected"
+          "name": "d2l-list-selection-change",
+          "description": "Dispatched when the selection state changes"
         }
       ],
       "slots": [
@@ -7068,10 +7033,12 @@
       ],
       "events": [
         {
-          "name": "d2l-menu-item-select"
+          "name": "d2l-menu-item-select",
+          "description": "Dispatched when the menu item is selected"
         },
         {
-          "name": "d2l-menu-item-visibility-change"
+          "name": "d2l-menu-item-visibility-change",
+          "description": "Dispatched when the visibility of the menu item changes"
         }
       ]
     },
@@ -7147,10 +7114,6 @@
         }
       ],
       "events": [
-        {
-          "name": "click",
-          "description": "Dispatched when the link is clicked"
-        },
         {
           "name": "d2l-menu-item-change",
           "description": "Dispatched when the selected menu item changes"
@@ -7330,7 +7293,7 @@
         },
         {
           "name": "d2l-menu-item-select",
-          "description": "Dispatched when a menu item is selected"
+          "description": "Dispatched when the menu item is selected"
         },
         {
           "name": "d2l-menu-item-visibility-change",
@@ -7382,10 +7345,12 @@
       ],
       "events": [
         {
-          "name": "d2l-menu-item-select"
+          "name": "d2l-menu-item-select",
+          "description": "Dispatched when the menu item is selected"
         },
         {
-          "name": "d2l-menu-item-visibility-change"
+          "name": "d2l-menu-item-visibility-change",
+          "description": "Dispatched when the visibility of the menu item changes"
         }
       ]
     },
@@ -7440,7 +7405,7 @@
       "events": [
         {
           "name": "d2l-menu-item-select",
-          "description": "Dispatched when a menu item is selected"
+          "description": "Dispatched when the menu item is selected"
         },
         {
           "name": "d2l-menu-item-visibility-change",
@@ -7784,7 +7749,7 @@
     {
       "name": "d2l-overflow-group",
       "path": "./components/overflow-group/overflow-group.js",
-      "description": "A component that can be used to display a set of buttons, links or menus that will be put into a\ndropdown menu when they no longer fit on the first line of their container",
+      "description": "A component that can be used to display a set of buttons, links or menus that will be put into a dropdown menu when they no longer fit on the first line of their container",
       "attributes": [
         {
           "name": "auto-show",
@@ -7963,7 +7928,8 @@
         },
         {
           "name": "selectionInfo",
-          "description": "The selection info (set by the selection component)."
+          "description": "The selection info (set by the selection component)",
+          "type": "object"
         },
         {
           "name": "disabled-tooltip",
@@ -8005,7 +7971,8 @@
         {
           "name": "selectionInfo",
           "attribute": "selectionInfo",
-          "description": "The selection info (set by the selection component)."
+          "description": "The selection info (set by the selection component)",
+          "type": "object"
         },
         {
           "name": "disabledTooltip",
@@ -8027,7 +7994,8 @@
           "description": "Dispatched when the user clicks the action; provides the selection info"
         },
         {
-          "name": "d2l-selection-observer-subscribe"
+          "name": "d2l-selection-observer-subscribe",
+          "description": "Internal event"
         }
       ]
     },
@@ -8131,10 +8099,8 @@
           "description": "Dispatched when the selected state changes"
         },
         {
-          "name": "d2l-selection-input-subscribe"
-        },
-        {
-          "name": "d2l-labelled-mixin-label-elem-change"
+          "name": "d2l-selection-input-subscribe",
+          "description": "Internal event"
         }
       ]
     },
@@ -8156,7 +8122,7 @@
         },
         {
           "name": "selectionInfo",
-          "description": "The selection info (set by the selection component).",
+          "description": "The selection info (set by the selection component)",
           "type": "object"
         }
       ],
@@ -8177,13 +8143,14 @@
         {
           "name": "selectionInfo",
           "attribute": "selectionInfo",
-          "description": "The selection info (set by the selection component).",
+          "description": "The selection info (set by the selection component)",
           "type": "object"
         }
       ],
       "events": [
         {
-          "name": "d2l-selection-observer-subscribe"
+          "name": "d2l-selection-observer-subscribe",
+          "description": "Internal event"
         }
       ]
     },
@@ -8194,7 +8161,7 @@
       "attributes": [
         {
           "name": "no-selection-text",
-          "description": "Text to display if no items are selected.",
+          "description": "Text to display if no items are selected",
           "type": "string"
         },
         {
@@ -8204,7 +8171,7 @@
         },
         {
           "name": "selectionInfo",
-          "description": "The selection info (set by the selection component).",
+          "description": "The selection info (set by the selection component)",
           "type": "object"
         }
       ],
@@ -8212,7 +8179,7 @@
         {
           "name": "noSelectionText",
           "attribute": "no-selection-text",
-          "description": "Text to display if no items are selected.",
+          "description": "Text to display if no items are selected",
           "type": "string"
         },
         {
@@ -8224,13 +8191,14 @@
         {
           "name": "selectionInfo",
           "attribute": "selectionInfo",
-          "description": "The selection info (set by the selection component).",
+          "description": "The selection info (set by the selection component)",
           "type": "object"
         }
       ],
       "events": [
         {
-          "name": "d2l-selection-observer-subscribe"
+          "name": "d2l-selection-observer-subscribe",
+          "description": "Internal event"
         }
       ]
     },
@@ -8240,7 +8208,7 @@
       "attributes": [
         {
           "name": "selection-single",
-          "description": "Whether the selection control is limited to single selection.",
+          "description": "Whether the selection control is limited to single selection",
           "type": "boolean",
           "default": "false"
         }
@@ -8249,15 +8217,10 @@
         {
           "name": "selectionSingle",
           "attribute": "selection-single",
-          "description": "Whether the selection control is limited to single selection.",
+          "description": "Whether the selection control is limited to single selection",
           "type": "boolean",
           "default": "false"
         }
-      ],
-      "events": [
-        {
-          "name": "d2l-selection-provider-connected"
-        }
       ]
     },
     {
@@ -8514,6 +8477,7 @@
     {
       "name": "d2l-switch-visibility",
       "path": "./components/switch/switch-visibility.js",
+      "description": "A variant of the generic switch configured with special icons and default text for toggling \"visibility\".",
       "attributes": [
         {
           "name": "text",
@@ -8594,13 +8558,15 @@
       ],
       "events": [
         {
-          "name": "change"
+          "name": "change",
+          "description": "Dispatched when the `on` property is updated"
         }
       ]
     },
     {
       "name": "d2l-switch",
       "path": "./components/switch/switch.js",
+      "description": "A generic switch with on/off semantics.",
       "attributes": [
         {
           "name": "text",
@@ -8681,7 +8647,8 @@
       ],
       "events": [
         {
-          "name": "change"
+          "name": "change",
+          "description": "Dispatched when the `on` property is updated"
         }
       ]
     },

package/helpers/focus.js

@@ -98,11 +98,13 @@ export function getPreviousFocusable(node, includeHidden) {
 	return focusable;
 }
 
-export function getNextFocusable(node, includeHidden) {
+export function getNextFocusable(node, includeHidden, ignore, ignoreChildren) {
 
 	if (!node) return null;
 
 	if (includeHidden === undefined) includeHidden = false;
+	if (ignore === undefined) ignore = true;
+	if (ignoreChildren === undefined) ignoreChildren = false;
 
 	const _getNextFocusable = (node, ignore, ignoreChildren) => {
 		if (!ignore && isFocusable(node, includeHidden)) return node;
@@ -128,7 +130,7 @@ export function getNextFocusable(node, includeHidden) {
 		return null;
 	};
 
-	const focusable = _getNextFocusable(node, true, false);
+	const focusable = _getNextFocusable(node, ignore, ignoreChildren);
 	return focusable;
 
 }

package/lang/ar.js

@@ -10,13 +10,13 @@ export default {
 	"components.dialog.close": "إغلاق مربع الحوار هذا",
 	"components.dropdown.close": "إغلاق",
 	"components.filter.clear": "مسح",
-	"components.filter.clearAll": "Clear All",
-	"components.filter.clearAllAnnounce": "Clearing all filters",
-	"components.filter.clearAllDescription": "Clear all filters",
-	"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.clearAll": "مسح الكل",
+	"components.filter.clearAllAnnounce": "جارٍ مسح كل عوامل التصفية",
+	"components.filter.clearAllDescription": "مسح كل عوامل التصفية",
+	"components.filter.clearAnnounce": "جارٍ مسح عوامل التصفية لـ: {filterName}",
+	"components.filter.clearAnnounceSingle": "جارٍ مسح عوامل التصفية",
+	"components.filter.clearDescription": "مسح عوامل التصفية لـ: {filterName}",
+	"components.filter.clearDescriptionSingle": "مسح عوامل التصفية",
 	"components.filter.loading": "يتم تحميل عوامل التصفية",
 	"components.filter.filterCountDescription": "{number, plural, zero {لم يتم تطبيق عوامل تصفية.} one {تم تطبيق عامل تصفية واحد.} other {{number} من عوامل التصفية التي تم تطبيقها.}}",
 	"components.filter.filters": "عوامل التصفية",

package/lang/cy.js

@@ -10,13 +10,13 @@ export default {
 	"components.dialog.close": "Cau'r dialog hwn",
 	"components.dropdown.close": "Cau",
 	"components.filter.clear": "Clirio",
-	"components.filter.clearAll": "Clear All",
-	"components.filter.clearAllAnnounce": "Clearing all filters",
-	"components.filter.clearAllDescription": "Clear all filters",
-	"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.clearAll": "Clirio’r Cyfan",
+	"components.filter.clearAllAnnounce": "Wrthi’n clirio’r holl hidlwyr",
+	"components.filter.clearAllDescription": "Clirio’r holl hidlwyr",
+	"components.filter.clearAnnounce": "Wrthi’n clirio hidlwyr ar gyfer: {filterName}",
+	"components.filter.clearAnnounceSingle": "Wrthi'n clirio hidlwyr",
+	"components.filter.clearDescription": "Wrthi’n clirio hidlwyd ar gyfer: {filterName}",
+	"components.filter.clearDescriptionSingle": "Clirio Hidlwyr",
 	"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

@@ -10,13 +10,13 @@ export default {
 	"components.dialog.close": "Luk denne dialogboks",
 	"components.dropdown.close": "Luk",
 	"components.filter.clear": "Ryd",
-	"components.filter.clearAll": "Clear All",
-	"components.filter.clearAllAnnounce": "Clearing all filters",
-	"components.filter.clearAllDescription": "Clear all filters",
-	"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.clearAll": "Ryd alle",
+	"components.filter.clearAllAnnounce": "Rydder alle filtre",
+	"components.filter.clearAllDescription": "Ryd alle filtre",
+	"components.filter.clearAnnounce": "Rydder filtre for: {filterName}",
+	"components.filter.clearAnnounceSingle": "Rydder filtre",
+	"components.filter.clearDescription": "Ryd filtre for: {filterName}",
+	"components.filter.clearDescriptionSingle": "Ryd filtre",
 	"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",