Function useMenu

packages/react-aria/src/menu/useMenu.ts:81–125

(
  props: AriaMenuOptions<T>,
  state: TreeState<T>,
  ref: RefObject<HTMLElement | null>
)

 * @param state - State for the menu, as returned by `useListState`.
 */
export function useMenu<T>(
  props: AriaMenuOptions<T>,
  state: TreeState<T>,
  ref: RefObject<HTMLElement | null>
): MenuAria {
  let {shouldFocusWrap = true, onKeyDown, onKeyUp, ...otherProps} = props;

  if (!props['aria-label'] && !props['aria-labelledby'] && process.env.NODE_ENV !== 'production') {
    console.warn('An aria-label or aria-labelledby prop is required for accessibility.');
  }

  let domProps = filterDOMProps(props, {labelable: true});
  let {listProps} = useSelectableList({
    ...otherProps,
    ref,
    selectionManager: state.selectionManager,
    collection: state.collection,
    disabledKeys: state.disabledKeys,
    shouldFocusWrap,
    linkBehavior: 'override'
  });

  menuData.set(state, {
    onClose: props.onClose,
    onAction: props.onAction,
    shouldUseVirtualFocus: props.shouldUseVirtualFocus
  });

  return {
    menuProps: mergeProps(
      domProps,
      {onKeyDown, onKeyUp},
      {
        role: 'menu',
        ...listProps,
        onKeyDown: e => {
          // don't clear the menu selected keys if the user is presses escape since escape closes the menu
          if (e.key !== 'Escape' || props.shouldUseVirtualFocus) {
            listProps.onKeyDown?.(e);
          }
        }
      }
    )
  };
}