Back to library

Popover

Show related controls in a small anchored panel.

Recommended API

Property or elementTypeExample initial valueDescription
popovertargetMatching element IDPer instanceAssociate a trigger with its non-modal popover.
aria-labelledbyElement IDProject visibility headingUse the visible panel title as the dialog’s accessible name.

States

StateTriggerResult
openActivate Details.The panel shows related information beside its trigger.
closedChoose Close, press Escape or click outside.The panel dismisses.

Svelte implementation guidance

The trigger opens a native popover. Escape, an outside click, and Close dismiss it.

Use the supplied Svelte 5 example. Use `$props.id()` to connect the native `popovertarget` attributes to a stable panel ID.

CSS variables

VariableTypeDefaultDescription
--q-textcolor #28302aMain text and foreground color.
--q-mutedcolor #70776fColor for secondary text.
--q-font-sizelength 13pxBase size for the component text.
--q-accentcolor #344e41Accent for active controls, indicators and focus.
--q-surfacecolor #ffffffSurface for controls and cards.
--q-bordercolor #dce0d8Color for outlines and dividers.
--q-radiuslength 10pxBase corner radius.
--q-spacelength 4pxBase unit for gaps and padding.
--q-shadowshadow 0 4px 16px rgb(0 0 0 / 8%)Shadow behind raised elements.