@wordpress/components
Version:
UI components for WordPress.
107 lines (91 loc) • 2.59 kB
text/typescript
import { useEffect } from '@wordpress/element';
const ROW_SELECTOR = 'tr:not([role]), [role="row"]';
const TREE_GRID_SELECTOR = '[role="treegrid"]';
function getAriaOwners( element: HTMLElement ) {
if ( ! element.id ) {
return [];
}
const escapedId = element.id
.replaceAll( '\\', '\\\\' )
.replaceAll( '"', '\\"' );
return Array.from(
element.ownerDocument.querySelectorAll< HTMLElement >(
`[aria-owns~="${ escapedId }"]`
)
);
}
function isContainedInOrOwnedBy(
element: HTMLElement,
selector: string,
visited = new Set< HTMLElement >()
): boolean {
if ( visited.has( element ) ) {
return false;
}
visited.add( element );
if ( element.parentElement?.closest( selector ) ) {
return true;
}
const hasValidOwner = getAriaOwners( element ).some(
( owner ) =>
owner.matches( selector ) ||
isContainedInOrOwnedBy( owner, selector, visited )
);
if ( hasValidOwner ) {
return true;
}
return element.parentElement
? isContainedInOrOwnedBy( element.parentElement, selector, visited )
: false;
}
function isOwnedByRowInTreeGrid(
element: HTMLElement,
visited = new Set< HTMLElement >()
): boolean {
if ( visited.has( element ) ) {
return false;
}
visited.add( element );
const hasValidOwner = getAriaOwners( element ).some( ( owner ) => {
const row = owner.matches( ROW_SELECTOR )
? owner
: owner.closest< HTMLElement >( ROW_SELECTOR );
return row
? isContainedInOrOwnedBy( row, TREE_GRID_SELECTOR )
: isOwnedByRowInTreeGrid( owner, visited );
} );
if ( hasValidOwner ) {
return true;
}
return element.parentElement
? isOwnedByRowInTreeGrid( element.parentElement, visited )
: false;
}
export function useValidateTreeGridStructure(
componentName: 'TreeGridRow' | 'TreeGridCell',
elementRef: React.RefObject<
HTMLTableCellElement | HTMLTableRowElement | null
>
) {
useEffect( () => {
const element = elementRef.current;
if ( ! element ) {
return;
}
const row =
element.parentElement?.closest< HTMLElement >( ROW_SELECTOR );
const hasValidStructure =
componentName === 'TreeGridRow'
? isContainedInOrOwnedBy( element, TREE_GRID_SELECTOR )
: ( row &&
isContainedInOrOwnedBy( row, TREE_GRID_SELECTOR ) ) ||
isOwnedByRowInTreeGrid( element );
if ( ! hasValidStructure ) {
throw new Error(
componentName === 'TreeGridRow'
? 'TreeGridRow must be rendered inside an element with role="treegrid".'
: 'TreeGridCell must be rendered as a cell in a row that belongs to an element with role="treegrid".'
);
}
}, [ componentName, elementRef ] );
}