@brightspace-ui/core 3.29.0 → 3.30.0

package/helpers/README.md

@@ -126,6 +126,9 @@ getComposedActiveElement()
 // gets the first focusable descendant given a node, including those within the shadow DOM
 getFirstFocusableDescendant(node, includeHidden, predicate, includeTabbablesOnly)
 
+// gets the focusable elements within the specified element
+getFocusableDescendants(node, { deep: false, disabled: false, hidden: false, predicate: elem => false, tabbablesOnly: true })
+
 // gets the focus pseudo-class to used in selectors (focus-visible if supported, or focus)
 // Usage:
 //	css`

package/helpers/focus.js

@@ -40,6 +40,25 @@ export function getFirstFocusableDescendant(node, includeHidden, predicate, incl
 	return null;
 }
 
+export function getFocusableDescendants(node, options) {
+	let focusables = [];
+
+	const composedChildren = getComposedChildren(node);
+	composedChildren.forEach(child => {
+		if (child.tagName === 'svg') return;
+		if (options?.predicate) {
+			if (!options.predicate(child)) return;
+		}
+
+		if (isFocusable(child, options?.hidden, options?.tabbablesOnly, options?.disabled)) focusables.push(child);
+		if (options?.deep) {
+			focusables = [...focusables, ...getFocusableDescendants(child, options)];
+		}
+	});
+
+	return focusables;
+}
+
 export function getFocusPseudoClass() {
 	return isFocusVisibleSupported() ? 'focus-visible' : 'focus';
 }

package/package.json

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