58f8093689
- Updated all component headers and documentation
- Changed navbar and footer branding
- Updated homepage hero badge
- Modified page title in index.html
- Simplified footer text to 'Built with ❤️'
- Consistent V2 capitalization across all references
78 lines
3.0 KiB
JavaScript
78 lines
3.0 KiB
JavaScript
import { toArray } from './array';
|
|
import { isAutoFocusAllowedCached, isVisibleCached, notHiddenInput } from './is';
|
|
import { orderByTabIndex } from './tabOrder';
|
|
import { getFocusables, getParentAutofocusables } from './tabUtils';
|
|
/**
|
|
* given list of focusable elements keeps the ones user can interact with
|
|
* @param nodes
|
|
* @param visibilityCache
|
|
*/
|
|
export var filterFocusable = function (nodes, visibilityCache) {
|
|
return toArray(nodes)
|
|
.filter(function (node) { return isVisibleCached(visibilityCache, node); })
|
|
.filter(function (node) { return notHiddenInput(node); });
|
|
};
|
|
export var filterAutoFocusable = function (nodes, cache) {
|
|
if (cache === void 0) { cache = new Map(); }
|
|
return toArray(nodes).filter(function (node) { return isAutoFocusAllowedCached(cache, node); });
|
|
};
|
|
/**
|
|
* !__WARNING__! Low level API.
|
|
* @returns all tabbable nodes
|
|
*
|
|
* @see {@link getFocusableNodes} to get any focusable element
|
|
*
|
|
* @param topNodes - array of top level HTMLElements to search inside
|
|
* @param visibilityCache - an cache to store intermediate measurements. Expected to be a fresh `new Map` on every call
|
|
*/
|
|
export var getTabbableNodes = function (topNodes, visibilityCache, withGuards) {
|
|
return orderByTabIndex(filterFocusable(getFocusables(topNodes, withGuards), visibilityCache), true, withGuards);
|
|
};
|
|
/**
|
|
* !__WARNING__! Low level API.
|
|
*
|
|
* @returns anything "focusable", not only tabbable. The difference is in `tabIndex=-1`
|
|
* (without guards, as long as they are not expected to be ever focused)
|
|
*
|
|
* @see {@link getTabbableNodes} to get only tabble nodes element
|
|
*
|
|
* @param topNodes - array of top level HTMLElements to search inside
|
|
* @param visibilityCache - an cache to store intermediate measurements. Expected to be a fresh `new Map` on every call
|
|
*/
|
|
export var getFocusableNodes = function (topNodes, visibilityCache) {
|
|
return orderByTabIndex(filterFocusable(getFocusables(topNodes), visibilityCache), false);
|
|
};
|
|
/**
|
|
* return list of nodes which are expected to be auto-focused
|
|
* @param topNode
|
|
* @param visibilityCache
|
|
*/
|
|
export var parentAutofocusables = function (topNode, visibilityCache) {
|
|
return filterFocusable(getParentAutofocusables(topNode), visibilityCache);
|
|
};
|
|
/*
|
|
* Determines if element is contained in scope, including nested shadow DOMs
|
|
*/
|
|
export var contains = function (scope, element) {
|
|
if (scope.shadowRoot) {
|
|
return contains(scope.shadowRoot, element);
|
|
}
|
|
else {
|
|
if (Object.getPrototypeOf(scope).contains !== undefined &&
|
|
Object.getPrototypeOf(scope).contains.call(scope, element)) {
|
|
return true;
|
|
}
|
|
return toArray(scope.children).some(function (child) {
|
|
var _a;
|
|
if (child instanceof HTMLIFrameElement) {
|
|
var iframeBody = (_a = child.contentDocument) === null || _a === void 0 ? void 0 : _a.body;
|
|
if (iframeBody) {
|
|
return contains(iframeBody, element);
|
|
}
|
|
return false;
|
|
}
|
|
return contains(child, element);
|
|
});
|
|
}
|
|
};
|