Pagination

Navigate through paged data with page numbers, size changers, and quick jumpers.

When to Use

  • To split large data sets across multiple pages
  • When users need to navigate between pages of content
  • For tables, lists, or search results with many items

Import

import { Pagination } from "orizon";

Examples

Basic

Simple pagination with total item count.

<Pagination defaultCurrent={1} total={50} />

With Size Changer

Allow users to change the number of items per page.

<Pagination
  defaultCurrent={1}
  total={100}
  showSizeChanger
/>

With Quick Jumper

Jump directly to a specific page number.

Go to
<Pagination
  defaultCurrent={1}
  total={200}
  showQuickJumper
/>

Show Total

Display the total number of items.

1-10 of 85 items
<Pagination
  total={85}
  showTotal={(total, range) =>
    `${range[0]}-${range[1]} of ${total} items`
  }
/>

Simple Mode

A compact pagination for limited space.

<Pagination simple defaultCurrent={1} total={50} />

Small Size

<Pagination size="small" defaultCurrent={1} total={50} />

Disabled

<Pagination disabled defaultCurrent={1} total={50} />

API

PaginationProps

  • currentnumber — Current page number (controlled)
  • defaultCurrentnumber — Default page number (default: 1)
  • pageSizenumber — Items per page (controlled)
  • defaultPageSizenumber — Default items per page (default: 10)
  • totalnumber — Total number of data items
  • showSizeChangerboolean — Show page size selector
  • pageSizeOptionsnumber[] — Options for page size selector (default: [10, 20, 50, 100])
  • showQuickJumperboolean — Show quick page jump input
  • showTotal(total: number, range: [number, number]) => ReactNode — Display total info
  • simpleboolean — Simple mode with only prev/next (default: false)
  • size"small" | "default" — Pagination size (default: "default")
  • disabledboolean — Disable all controls (default: false)
  • onChange(page: number, pageSize: number) => void — Page change callback
  • onShowSizeChange(current: number, size: number) => void — Page size change callback