ComponentsPagination

overlaystexulinot agent-emittableapp

Pagination

pagination

Page controls for long lists.

Live examples

Twelve pages

Twelve pages

Loading demo…

Props

Public props for Pagination
NameKindRequiredDefaultDescription
pagenumberno1—
pageCountnumberyes——
sizeenum (sm, md, lg)no"md"—
variantenum (outline, soft)no"outline"—
onPageChangeeventno——
classstringno——
childrenslotno——
labelstringno——

Keyboard

Keyboard behavior for Pagination
KeyAction
—See accessibility notes for keyboard behavior.

Accessibility

  • Named navigation; previous/next buttons disabled at ends.

Evidence for pagination

Latest committed gates for pagination (as of 2026-10-23). Static snapshot — not live CI.

Behavior

checkedscenario pagination

5 checks

Rows in tests/behavior/scenarios/pagination.spec.ts, held to the WAI-ARIA APG pattern, run on Chromium, WebKit and the Pixel 7.

Size (gzip)

texuli/pagination · budget 12.0 KiB

Budget from texuli.budgets.json; re-measure with `pnpm size --filter <entry>`.

Axe

documented

  • tests/e2e/site-component-pages.spec.ts
  • docs/quality (a11y-*)

Site component pages axe gate; package-level a11y docs under docs/quality when present.

Browsers

  • chromium
  • webkit
  • mobile

Playwright projects: Desktop Chrome, Desktop Safari, Pixel 7. Firefox is a known gap on this host.

When to use

Use when

  • Paging tables or search results

Don’t use when

Prefer another component

  • Infinite scroll only feeds