import { RestoreSelection, snapshotSelection, restoreSelection, } from './utils/selection'; import { getFirstFocusTarget, getFocusTargets, focus } from './utils/focus'; import { click } from './utils/click'; import { useLayoutEffect } from './utils/react'; import { contains, isInputElement } from './utils/element'; import { Ref } from './types'; export interface MenuFocusOptions { disabled?: boolean; ownerRef?: Ref; } export function useMenuFocus( ref: Ref, options?: MenuFocusOptions ) { const ownerRef = options && options.ownerRef; const disabled = !!(options && options.disabled); useLayoutEffect(() => { const { current: element } = ref; if (!element || disabled) return; let selection: RestoreSelection | null = null; function onFocus(event: FocusEvent) { if (!element || event.defaultPrevented) return; const owner = (ownerRef && ownerRef.current) || (selection && selection.element); const { relatedTarget, target } = event; if (relatedTarget === owner) { // When owner is explicitly passed we can make a snapshot early selection = snapshotSelection(owner); } else if ( contains(element, target) && !contains(element, relatedTarget) && (!ownerRef || contains(relatedTarget, ownerRef.current)) ) { // Check whether focus is about to move into the container and snapshot last focus selection = snapshotSelection(owner); } else if ( contains(element, relatedTarget) && !contains(element, target) ) { // Reset focus if it's lost and has left the menu selection = null; } } function onKey(event: KeyboardEvent) { if (!element || event.defaultPrevented || event.isComposing) return; const owner = (ownerRef && ownerRef.current) || (selection && selection.element); const active = document.activeElement as HTMLElement; const focusTargets = getFocusTargets(element); if ( !focusTargets.length || (!contains(element, active) && !contains(owner, active)) ) { // Do nothing if container doesn't contain focus or not targets are available return; } if ( (!isInputElement(active) && event.code === 'ArrowRight') || event.code === 'ArrowDown' ) { // Implement forward movement in focus targets event.preventDefault(); const focusIndex = focusTargets.indexOf(active); const nextIndex = focusIndex < focusTargets.length - 1 ? focusIndex + 1 : 0; focus(focusTargets[nextIndex]); } else if ( (!isInputElement(active) && event.code === 'ArrowLeft') || event.code === 'ArrowUp' ) { // Implement backward movement in focus targets event.preventDefault(); const focusIndex = focusTargets.indexOf(active); const nextIndex = focusIndex > 0 ? focusIndex - 1 : focusTargets.length - 1; focus(focusTargets[nextIndex]); } else if (event.code === 'Home') { // Implement Home => first item event.preventDefault(); focus(focusTargets[0]); } else if (event.code === 'End') { // Implement End => last item event.preventDefault(); focus(focusTargets[focusTargets.length - 1]); } else if ( owner && isInputElement(owner) && contains(owner, active) && event.code === 'Enter' ) { // Move focus to first target when enter is pressed focus(getFirstFocusTarget(element)); } else if ( owner && !contains(ref.current, owner) && !contains(owner, active) && event.code === 'Escape' ) { // Restore selection if escape is pressed event.preventDefault(); restoreSelection(selection); } else if ( (event.code === 'Enter' || event.code === 'Space') && focusTargets.indexOf(active) > -1 && !isInputElement(active) ) { // Implement virtual click / activation for list items event.preventDefault(); click(active); } else if ( owner && isInputElement(owner) && !contains(owner, active) && /^(?:Key|Digit)/.test(event.code) ) { // Restore selection if a key is pressed on input restoreSelection(selection); } } document.body.addEventListener('focusin', onFocus); document.addEventListener('keydown', onKey); return () => { const active = document.activeElement as HTMLElement; if (!active || contains(element, active)) { restoreSelection(selection); } document.body.removeEventListener('focusin', onFocus); document.removeEventListener('keydown', onKey); }; }, [ref.current, disabled]); }