Back to library

Pagination

Split a long list, such as search results or products, into pages people can navigate.

Recommended API

Property or elementTypeExample initial valueDescription
Current pageInteger1Identify the current page out of the four example pages.
aria-currentARIA tokenpage on the active buttonMark the current page for assistive technologies.

States

StateTriggerResult
changedChoose a page or use an arrow button.The current page and its button styling move together.
boundaryReach the first or last page.The unavailable direction is disabled.

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-on-accentcolor #ffffffForeground on the accent background.
--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-durationtime 175msDuration of visual state transitions.
--q-spacelength 4pxBase unit for gaps and padding.