@aria-ui/popover

Type Aliases

EscapeKeyDownEvent

type EscapeKeyDownEvent = CustomEvent<{ originalEvent: KeyboardEvent; }>

PopoverContent

PopoverContentDataAttributes

Properties

data-align: "center" | "start" | "end"

data-mounted: ""

data-side: "bottom" | "left" | "right" | "top"

data-state: "open" | "closed"

PopoverContentEvents

Properties

escapeKeyDown: EscapeKeyDownEvent

Fired when the escape key is pressed.

By default, the popover will be closed. It can be prevented by calling preventDefault().

focusOutside: FocusOutsideEvent

Fired when the focus is moved outside the element.

By default, the popover will be closed. It can be prevented by calling preventDefault().

interactOutside: InteractOutsideEvent

Fired when an interaction (pointer or focus) happens outside the component.

By default, the popover will be closed. It can be prevented by calling preventDefault().

pointerDownOutside: PointerDownOutsideEvent

Fired when the pointer is pressed down outside the element.

By default, the popover will be closed. It can be prevented by calling preventDefault().

PopoverContentProps

Properties

altBoundary: boolean

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

Default

false

autoUpdate: boolean | AutoUpdateOptions

Options to activate auto-update listeners

See

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

Default

true

boundary: 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.

Default

'clippingAncestors'

elementContext: ElementContext

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

Default

'floating'

fitViewport: boolean

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

Default

false

flip: boolean | Placement[]

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.

Default

true

hide: boolean

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

Default

false

hoist: boolean

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>.

Default

true

inline: boolean

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

Default

false

offset?: OffsetOptions

The distance between the reference and floating element.

Default

6

overflowPadding: number

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

Default

4

overlap: boolean

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

Default

false

placement: Placement

The initial placement of the floating element

Default

"top"

rootBoundary: 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.

Default

'viewport'

sameHeight: boolean

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

Default

false

sameWidth: boolean

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

Default

false

shift: boolean

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

Default

true

strategy: "fixed" | "absolute"

The strategy to use for positioning

Default

"absolute"

transform: boolean

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.

Default

false

popoverRootEvents

const popoverRootEvents: EventDeclarations<PopoverRootEvents>

PopoverRoot

PopoverRootEvents

Properties

openChange: CustomEvent<boolean>

PopoverRootProps

Properties

defaultOpen: boolean

Whether the popover is open by default.

Default

false

open: boolean

Whether the popover is open.

Default

false