Pagination

Page links: borderless, with the current page filled with the accent color.

@cupertinoui/paginationRegistry JSON

import {
  Pagination,
  PaginationContent,
  PaginationEllipsis,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"

export default function PaginationDemo() {
  return (
    <Pagination>
      <PaginationContent>
        <PaginationItem>
          <PaginationPrevious href="#" />
        </PaginationItem>
        <PaginationItem>
          <PaginationLink href="#">1</PaginationLink>
        </PaginationItem>
        <PaginationItem>
          <PaginationLink href="#" isActive>
            2
          </PaginationLink>
        </PaginationItem>
        <PaginationItem>
          <PaginationLink href="#">3</PaginationLink>
        </PaginationItem>
        <PaginationItem>
          <PaginationEllipsis />
        </PaginationItem>
        <PaginationItem>
          <PaginationNext href="#" />
        </PaginationItem>
      </PaginationContent>
    </Pagination>
  )
}

Installation

pnpm dlx shadcn@latest add @cupertinoui/pagination

The first install also adds the macOS theme. See Installation to set up the registry.

Usage

import { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious } from "@/components/ui/pagination"

<Pagination>
  <PaginationContent>
    <PaginationItem><PaginationPrevious href="#" /></PaginationItem>
    <PaginationItem><PaginationLink href="#" isActive>2</PaginationLink></PaginationItem>
    <PaginationItem><PaginationNext href="#" /></PaginationItem>
  </PaginationContent>
</Pagination>

API Reference

Every part forwards the props of the underlying element. The props below are the ones CupertinoUI adds or changes.

PaginationLink

Prop	Type	Description
`isActive`	`boolean` Default: `false`	Marks the current page.
`className`	`string`	Extra classes, merged with the component's own.

PaginationPrevious / PaginationNext

Prop	Type	Description
`text`	`string`	The label, hidden on small screens.
`className`	`string`	Extra classes, merged with the component's own.