@brightspace-ui/core 2.40.0 → 2.41.0

package/helpers/README.md

@@ -107,6 +107,10 @@ isComposedAncestor(ancestorNode, node);
 
 // returns true/false whether the element is visible regardless of positioning
 isVisible(node);
+
+// similar to document.querySelector or element.querySelector,
+// except it queries not just the light DOM but also shadow DOM
+querySelectorComposed(node, selector)
 ```
 
 ## Focus

package/helpers/dom.js

@@ -227,3 +227,26 @@ export function isVisible(node) {
 	return true;
 
 }
+
+export function querySelectorComposed(node, selector) {
+
+	if (!node || (node.nodeType !== 1 && node.nodeType !== 9 && node.nodeType !== 11)) {
+		throw new TypeError('Invalid node. Must be nodeType document, element or document fragment');
+	}
+	if (typeof selector !== 'string') {
+		throw new TypeError('Invalid selector');
+	}
+
+	const elem = node.querySelector(selector);
+	if (elem) return elem;
+
+	const allElems = node.querySelectorAll('*');
+	for (const elem of allElems) {
+		if (elem.shadowRoot) {
+			const nestedElem = querySelectorComposed(elem.shadowRoot, selector);
+			if (nestedElem) return nestedElem;
+		}
+	}
+
+	return null;
+}

package/package.json

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