120k

Pagination

Pagination with page navigation, next and previous links.

Installation

pnpm dlx shadcn@latest add @force-ui-ember/pagination

Usage

import {
  Pagination,
  PaginationContent,
  PaginationEllipsis,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from '@/ui/pagination';
<Pagination>
  <PaginationContent>
    <PaginationItem>
      <PaginationPrevious href="#" />
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="#">1</PaginationLink>
    </PaginationItem>
    <PaginationItem>
      <PaginationLink @isActive={{true}} href="#">
        2
      </PaginationLink>
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="#">3</PaginationLink>
    </PaginationItem>
    <PaginationItem>
      <PaginationEllipsis />
    </PaginationItem>
    <PaginationItem>
      <PaginationNext href="#" />
    </PaginationItem>
  </PaginationContent>
</Pagination>

Composition

Use the following composition to build a Pagination:

Pagination
└── PaginationContent
    ├── PaginationItem
    │   └── PaginationPrevious
    ├── PaginationItem
    │   └── PaginationLink
    ├── PaginationItem
    │   └── PaginationEllipsis
    └── PaginationItem
        └── PaginationNext

Examples

Simple

A simple pagination with only page numbers.

Icons Only

Use just the previous and next buttons without page numbers. This is useful for data tables with a rows per page selector.

RTL

To enable RTL support in Force UI, see the RTL configuration guide.

API Reference

Pagination

The root pagination component that wraps all pagination elements.

PropTypeDefault
@classstringundefined

PaginationContent

A list wrapper for pagination items.

PropTypeDefault
@classstringundefined

PaginationItem

A list item that wraps individual pagination elements.

PropTypeDefault
@classstringundefined

A clickable link for individual page numbers.

PropTypeDefault
@isActivebooleanfalse
@size"default" | "sm" | "lg" | "icon""icon"
@classstringundefined

PaginationPrevious

A link to navigate to the previous page.

PropTypeDefault
@classstringundefined

PaginationNext

A link to navigate to the next page.

PropTypeDefault
@classstringundefined

PaginationEllipsis

An ellipsis indicator for skipped pages.

PropTypeDefault
@classstringundefined