Back to library

Contextual help

Add a short hint or supporting explanation beside the relevant control.

Recommended API

Property or elementTypeExample initial valueDescription
aria-describedbyElement IDPer instanceAssociate short help text with the trigger.
role="tooltip"ARIA role—Mark non-interactive, supplementary help.

States

StateTriggerResult
shownHover or focus the trigger.The short hint appears nearby.
hiddenMove the pointer away or leave keyboard focus.The hint disappears when neither interaction remains.

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-border-widthlength 1pxThickness of the outline.
--q-radiuslength 10pxBase corner radius.
--q-gaplength calc(var(--q-space) * 2)Space between items, based on the spacing unit.
--q-control-pxlength calc(var(--q-space) * 4)Horizontal padding for controls.
--q-control-pylength calc(var(--q-space) * 2.5)Vertical padding for controls.
--q-durationtime 175msDuration of visual state transitions.
--q-spacelength 4pxBase unit for gaps and padding.