Back to library

Skeleton

Reserve space for a card or list while its data loads.

Recommended API

Property or elementTypeExample initial valueDescription
role and aria-labelARIA attributesstatus, Loading contentExpose the placeholder as a loading message.
Placeholder layoutMarkupCard-shaped blocksReserve space for the eventual content.

States

StateTriggerResult
loadingRender the placeholder before content arrives.The skeleton holds space for the pictured structure.

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-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-panel-paddinglength calc(var(--q-space) * 5)Inner padding for panels.
--q-shadowshadow 0 4px 16px rgb(0 0 0 / 8%)Shadow behind raised elements.
--q-spacelength 4pxBase unit for gaps and padding.