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'