> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Pagination component documentation. Learn how to configure pagination parameters and page-change events to enable paginated loading of large data volumes when used with components such as the Spreadsheet.

## When to Use

* Use it when a large volume of content needs to be loaded page by page.

## Component Example

## Component Properties

| Attribute          | Description                                                                                                                   | Type                                                           | Default     |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------- |
| `current`          | Current page number                                                                                                           | `number`                                                       | `1`         |
| `hideOnlyOnePage`  | Whether to hide the paginator when there is only one page                                                                     | `boolean`                                                      | `false`     |
| `onChange`         | Triggered when the page number changes                                                                                        | `(currentPagination: number) => void`                          | -           |
| `onPageSizeChange` | Triggered when the page size changes                                                                                          | `(pageSize: number) => void`                                   | -           |
| `pageSize`         | Number of items displayed per page                                                                                            | `number`                                                       | `10`        |
| `pageSizeList`     | Selectable values for the page size selector                                                                                  | `string`                                                       | `'5,10,20'` |
| `pageSizePosition` | Position of the page size selector within the component                                                                       | `'start' \| 'end'`                                             | `'end'`     |
| `pageSizeSelector` | Type of the page size selector                                                                                                | `false \| 'filter' \| 'dropdown'`                              | `false`     |
| `shape`            | Style of the previous/next buttons                                                                                            | `'normal' \| 'arrow-only' \| 'arrow-prev-only' \| 'no-border'` | `'normal'`  |
| `showJump`         | Whether to show the jump-to input and Button. Takes effect only when **type** is `normal` and the total page count exceeds 5. | `boolean`                                                      | `true`      |
| `size`             | Pagination size                                                                                                               | `'small' \| 'medium' \| 'large'`                               | `'medium'`  |
| `total`            | Total number of records                                                                                                       | `number`                                                       | -           |
| `type`             | Pagination type                                                                                                               | `'normal' \| 'simple' \| 'mini'`                               | `'normal'`  |