useMenuTriggerState

Manages state for a menu trigger. Tracks whether the menu is currently open, and controls which item will receive focus when it opens.

install	`yarn add @react-stately/menu`
version	3.0.0
usage	`import {useMenuTriggerState} from '@react-stately/menu'`

API#

useMenuTriggerState(
  (props: MenuTriggerProps
)): MenuTriggerState

Name	Type	Description
`focusStrategy`	`FocusStrategy`	Controls which item will be auto focused when the menu opens.
`isOpen`	`boolean`	Whether the overlay is currently open.

Method	Description
`toggle( (focusStrategy: FocusStrategy \| \| null )): void`	Toggles the menu.
`open(): void`	Opens the overlay.
`close(): void`	Closes the overlay.

See the docs for useMenuTrigger in react-aria for an example of useMenuTriggerState.

Name	Type	Description
`align`	`Alignment`	Where the Menu aligns with its trigger.
`direction`	`'bottom' \| 'top'`	Where the Menu opens relative to its trigger.
`closeOnSelect`	`boolean`	Whether the Menu closes when a selection is made.
`shouldFlip`	`boolean`	Whether the element should flip its orientation when there is insufficient space for it to render within the view.
`isOpen`	`boolean`	Whether the overlay is open by default (controlled).
`defaultOpen`	`boolean`	Whether the overlay is open by default (uncontrolled).
`onOpenChange`	`( (isOpen: boolean )) => void`	Handler that is called when the overlay's open state changes.

'start' | 'end'

Name	Type	Description
`focusStrategy`	`FocusStrategy`	Controls which item will be auto focused when the menu opens.
`isOpen`	`boolean`	Whether the overlay is currently open.

Method	Description
`toggle( (focusStrategy: FocusStrategy \| \| null )): void`	Toggles the menu.
`open(): void`	Opens the overlay.
`close(): void`	Closes the overlay.

'first' | 'last'