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-alpha.1
usage	`import {useMenuTriggerState} from '@react-stately/menu'`

API#

useMenuTriggerState(props: MenuTriggerProps): MenuTriggerState

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

Method	Description
`setOpen(value: boolean): void`	Sets whether the menu is open.
`setFocusStrategy(value: FocusStrategy): void`	Sets which item will be auto focused when the menu opens.
`open(): void`	Opens the menu.
`close(): void`	Closes the menu.
`toggle(focusStrategy: FocusStrategy \| null): void`	Toggles the menu.

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.
`isOpen`	`boolean`	Whether the Menu loads open (controlled).
`defaultOpen`	`boolean`	Whether the Menu loads open (uncontrolled).
`onOpenChange`	`(isOpen: boolean) => void`	Handler that is called when the Menu opens or closes.
`shouldFlip`	`boolean`	Whether the element should flip its orientation when there is insufficient space for it to render within the view.

'start' | 'end'

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

Method	Description
`setOpen(value: boolean): void`	Sets whether the menu is open.
`setFocusStrategy(value: FocusStrategy): void`	Sets which item will be auto focused when the menu opens.
`open(): void`	Opens the menu.
`close(): void`	Closes the menu.
`toggle(focusStrategy: FocusStrategy \| null): void`	Toggles the menu.

'first' | 'last'