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
67 lines
2.8 KiB
JavaScript
67 lines
2.8 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 const filterFocusable = (nodes, visibilityCache) => toArray(nodes)
|
|
.filter((node) => isVisibleCached(visibilityCache, node))
|
|
.filter((node) => notHiddenInput(node));
|
|
export const filterAutoFocusable = (nodes, cache = new Map()) => toArray(nodes).filter((node) => 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 const getTabbableNodes = (topNodes, visibilityCache, withGuards) => 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 const getFocusableNodes = (topNodes, visibilityCache) => orderByTabIndex(filterFocusable(getFocusables(topNodes), visibilityCache), false);
|
|
/**
|
|
* return list of nodes which are expected to be auto-focused
|
|
* @param topNode
|
|
* @param visibilityCache
|
|
*/
|
|
export const parentAutofocusables = (topNode, visibilityCache) => filterFocusable(getParentAutofocusables(topNode), visibilityCache);
|
|
/*
|
|
* Determines if element is contained in scope, including nested shadow DOMs
|
|
*/
|
|
export const contains = (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((child) => {
|
|
var _a;
|
|
if (child instanceof HTMLIFrameElement) {
|
|
const iframeBody = (_a = child.contentDocument) === null || _a === void 0 ? void 0 : _a.body;
|
|
if (iframeBody) {
|
|
return contains(iframeBody, element);
|
|
}
|
|
return false;
|
|
}
|
|
return contains(child, element);
|
|
});
|
|
}
|
|
};
|