Navigation & disclosure@neumorphism-ui/pagination

Pagination

Composable pagination that preserves the semantics of nav, ul, li, and anchor. Provides an active page, previous and next links, and a collapsed-range indicator.

@neumorphism-ui/pagination
Registry JSON

Preview

Installation

Installation: paginationnpx shadcn@latest add @neumorphism-ui/pagination

The CLI resolves npm dependencies, base tokens, utilities, and component source in order.

New to this Registry? Set up the namespace before continuing.

Usage

Import

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

Example

Pagination usage code
<Pagination>
  <PaginationContent>
    <PaginationItem>
      <PaginationPrevious href="?page=1" />
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="?page=1">1</PaginationLink>
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="?page=2" isActive>2</PaginationLink>
    </PaginationItem>
    <PaginationItem><PaginationEllipsis /></PaginationItem>
    <PaginationItem>
      <PaginationNext href="?page=3" />
    </PaginationItem>
  </PaginationContent>
</Pagination>

API Reference

ComponentPropTypeDefaultDescription
Paginationaria-labelstring"pagination"The accessible name of the pagination navigation region.
PaginationLinkhrefrequiredstring—The actual URL of the target page.
PaginationLinkisActivebooleanfalseApplies the current-page style and aria-current=page.
PaginationPrevious / PaginationNextchildrenReact.ReactNode"Previous" / "Next"Replaces the default navigation label.

Accessibility

  • 01

    Each page should be a link with a real href to preserve browser navigation and opening in a new tab.

  • 02

    Set isActive on exactly one current page to apply aria-current=page.

  • 03

    Previous and Next include default aria-label values; override them when localization is required.