Pagination
Freev1.0.0The shadcn Pagination parts, plus a complete pager with range and page window.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import * as React from "react";
import { Pagination } from "@/components/ui/notchset/pagination";
export function RunsPager() {
const [page, setPage] = React.useState(1);
return <Pagination aria-label="Runs pages" total={22} page={page} onPageChange={setPage} perPage={10} count={214} itemLabel="Runs" />;
}Props
total–numberPages in all; makes Pagination the instrument.
page / defaultPage / onPageChange–number / (page) => voidThe current page.
perPage / count / itemLabel–number / number / stringThe range header ("RUNS 11–20 OF 214").
siblings–numberPages beside the current one. Default 1 (seven slots).
ruler–booleanThe position ruler. Default true.
PaginationLink isActive–booleanAs shadcn.
Anatomy
- Same parts as shadcn's Pagination, plus the instrument when given a total.
- No primitive needed: one file serves both builds.
- The Notchset instrument parts: glyph flip; a tick through beautiful-ui-sound on change.
Paginationdata-slot="pagination"The nav.
Listdata-slot="pagination-list"The window of pages.
Rulerdata-slot="pagination-ruler"The position ruler.
Source
components/ui/notchset/pagination.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/pagination.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/pagination.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/pagination.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Paging a table or list
- A drop-in for shadcn's Pagination parts
Use something else when
- Infinite feeds: load more as you scroll
Mistakes to avoid
- Pass count and perPage for the range header, or it shows the page alone
Agents find it by
- pagination, pager, pages, table pages, runs pages, shadcn pagination, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/pagination.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ← →
- Previous or next page
- Home / End
- First or last page
Accessibility
- A <nav> with a label; the current page has aria-current="page"
- The range header is aria-live; ellipses are hidden from screen readers
- Prev and next at the ends are aria-disabled
Motion
- Change
- The ink block slides 340ms cubic-bezier(.34,1.25,.5,1); the label turns on-ink after 110ms; the ruler's node glides 420ms
- Window
- Slot labels flip when the window shifts
- Keys
- The arrow nudges 2px outward on hover
Responsive
- Collapses to a gap node between page groups so it fits narrow widths.
- 44px cells on touch screens.
Performance
- Pages are plain buttons; the page number flips text only when it changes.
- The slot list is computed from total and page, nothing measured.
Changelog
v1.0.0 · 2026-10-02
First release
