Whether the popover is initially open.

To render a controlled popover, use the open prop instead.

ID of the trigger that the popover is associated with. This is useful in conjunction with the defaultOpen prop to create an initially open popover.

A handle to associate the popover with a trigger. If specified, allows external triggers to control the popover's open state.

Determines if the popover enters a modal state when open.

• true: user interaction is limited to the popover: document page scroll is locked, and pointer interactions on outside elements are disabled.
• false: user interaction with the rest of the document is allowed.
• 'trap-focus': focus is trapped inside the popover, but document page scroll is not locked and pointer interactions outside of it remain enabled.

On touch devices, a true modal blocks outside taps but leaves the page scrollable unless the popup spans nearly the full viewport width, matching native iOS behavior.

When modal is true, focus trapping is enabled only if <Popover.Close> is rendered inside <Popover.Popup>. It can be visually hidden with your own CSS if needed, such as Tailwind's sr-only utility.

When modal is 'trap-focus', render <Popover.Close> inside <Popover.Popup> so touch screen readers can escape the popup.

Event handler called when the popover is opened or closed.

Event handler called after any animations complete when the popover is opened or closed.

Whether the popover is currently open.

The size of the component.

ID of the trigger that the popover is associated with. This is useful in conjunction with the open prop to create a controlled popover. There's no need to specify this prop when the popover is uncontrolled (that is, when the open prop is not set).

The visual style of the component.

The visual style of the component.

An element to position the popup against. Defaults to the trigger.

How the popup avoids collisions with the edges of the viewport.

Determines the element to focus when the popover is closed.

• false: Do not move focus.
• true: Move focus based on the default behavior (trigger or previously focused element).
• RefObject: Move focus to the ref element.
• function: Called with the interaction type (mouse, touch, pen, or keyboard). Return an element to focus, true to use the default behavior, null to fall back to the default behavior, or false/undefined to do nothing.

Whether to hide the arrow that points at the trigger.

Determines the element to focus when the popover is opened. By default, focus moves to the first tabbable element inside the popup, except when the popover is opened by touch — then the popup itself is focused to avoid opening the virtual keyboard.

• false: Do not move focus.
• true: Move focus based on the default behavior (first tabbable element or popup).
• RefObject: Move focus to the ref element.
• function: Called with the interaction type (mouse, touch, pen, or keyboard). Return an element to focus, true to use the default behavior, null to fall back to the default behavior, or false/undefined to do nothing.

Which side of the copy button the tooltip and toast open on.

The gap between the trigger and the calendar, in pixels.

Whether the popup uses the compact look of a tooltip: smaller text, tighter padding and a width that fits the content.

A handle to associate the trigger with a popover.

Replaces this icon. Accepts any node; null renders no icon. Takes precedence over IconProvider.

ID of the trigger. In addition to being forwarded to the rendered element, it is also used to specify the active trigger for the popover in controlled mode (with the PopoverRoot triggerId prop).

Whether the component renders a native <button> element when replacing it via the render prop. Set to false if the rendered element is not a button (for example, <div>). Whether the component renders a native <button> element when replacing it via the render prop. Set to false if the rendered element is not a button (e.g. <div>).

Whether the popover should also open when the trigger is hovered.

A payload to pass to the popover when it is opened.