@aria-ui/menu

MenuContentProps #

altBoundary

Whether to check the alternate elementContext’s boundary. Please see https://floating-ui.com/docs/detectoverflow#altboundary for more information.

Type: boolean

Default: false

autoUpdate

Options to activate auto-update listeners

Type: boolean | AutoUpdateOptions

See

https://floating-ui.com/docs/autoUpdate

Default: true

boundary

Describes the clipping element(s) or area that overflow will be checked relative to. Please see https://floating-ui.com/docs/detectoverflow#boundary for more information.

Type: Boundary

Default: 'clippingAncestors'

elementContext

The element that will be used to check for overflow. Please see https://floating-ui.com/docs/detectoverflow#elementcontext for more information.

Type: ElementContext

Default: 'floating'

eventTarget

By default, the menu element will listen for keydown events. You can pass a different element to listen for keydown events.

Type: HTMLElement | TypedEventTarget<"keydown">

fitViewport

Whether to constrain the floating element's width and height to not exceed the viewport.

Type: boolean

Default: false

flip

Whether to flip the placement in order to keep it in view when the preferred placement(s) will overflow the clipping boundary. You can also provide an array of placements to try sequentially if the preferred placement does not fit.

Type: boolean | Placement[]

Default: true

hide

Whether to hide the floating element when the reference element or the floating element is fully clipped.

Type: boolean

Default: false

hoist

Whether to use the browser Popover API to place the floating element on top of other page content. When enabled, the floating element won't be clipped by an ancestor. This provides a similar result to React's <Portals> or Vue's <Teleport>.

Type: boolean

Default: true

inline

Whether to improve positioning for inline reference elements that span over multiple lines.

Type: boolean

Default: false

offset

The distance between the reference and floating element.

Type: OffsetOptions

Default: 6

overflowPadding

Describes the virtual padding around the boundary to check for overflow. Please see https://floating-ui.com/docs/detectoverflow#padding for more information.

Type: number

Default: 4

overlap

Whether the floating element can overlap the reference element to keep it in view.

Type: boolean

Default: false

placement

The initial placement of the floating element

Type: Placement

Default: "top"

rootBoundary

Describes the root boundary that the element will be checked for overflow relative to. Please see https://floating-ui.com/docs/detectoverflow#rootboundary for more information.

Type: RootBoundary

Default: 'viewport'

sameHeight

Whether to constrain the floating element's height so that it matches the reference element.

Type: boolean

Default: false

sameWidth

Whether to constrain the floating element's width so that it matches the reference element.

Type: boolean

Default: false

shift

Whether the floating element should shift to keep it in view.

Type: boolean

Default: true

strategy

The strategy to use for positioning

Type: "fixed" | "absolute"

Default: "absolute"

transform

Whether to use CSS transforms to position the floating element instead of layout (top and left CSS properties). CSS transforms are more performant, but can cause conflicts with transform animations.

Type: boolean

Default: false

MenuItemEvents #

select

Fired when the item is selected.

Type: CustomEvent<void>

MenuItemProps #

filter

The filter function to determine if an item should be shown in the listbox.

Type: ItemFilter

Default: defaultItemFilter

query

The query string to filter the listbox items.

Type: string

Default: ""

value

The value of the item. Every item must have a unique value in the parent list. By default, a random value is generated.

Type: string

Default: ""

MenuContentEvents #

Type: PopoverContentEvents

MenuRootEvents #

Type: PopoverRootEvents

MenuRootProps #

Type: PopoverRootProps