mirror of
https://github.com/ant-design/ant-design.git
synced 2024-11-28 05:05:48 +08:00
40e77c40d3
* docs: add dark overview * docs: show dark cover in dark theme * docs: update cover
2.8 KiB
2.8 KiB
category | group | title | cover | coverDark |
---|---|---|---|---|
Components | Navigation | Pagination | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*8y_iTJGY_aUAAAAAAAAAAAAADrJ8AQ/original | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*WM86SrBC8TsAAAAAAAAAAAAADrJ8AQ/original |
A long list can be divided into several pages using Pagination
, and only one page will be loaded at a time.
When To Use
- When it will take a long time to load/render all items.
- If you want to browse the data by navigating through pages.
Examples
Basic
More
Changer
Jumper
Mini size
Simple mode
Controlled
Total number
Show All
Prev and next
Wireframe
API
<Pagination onChange={onChange} total={50} />
Property | Description | Type | Default | Version |
---|---|---|---|---|
current | Current page number | number | - | |
defaultCurrent | Default initial page number | number | 1 | |
defaultPageSize | Default number of data items per page | number | 10 | |
disabled | Disable pagination | boolean | - | |
hideOnSinglePage | Whether to hide pager on single page | boolean | false | |
itemRender | To customize item's innerHTML | (page, type: 'page' | 'prev' | 'next', originalElement) => React.ReactNode | - | |
pageSize | Number of data items per page | number | - | |
pageSizeOptions | Specify the sizeChanger options | string[] | [10 , 20 , 50 , 100 ] |
|
responsive | If size is not specified, Pagination would resize according to the width of the window |
boolean | - | |
showLessItems | Show less page items | boolean | false | |
showQuickJumper | Determine whether you can jump to pages directly | boolean | { goButton: ReactNode } | false | |
showSizeChanger | Determine whether to show pageSize select, it will be true when total > 50 |
boolean | - | |
showTitle | Show page item's title | boolean | true | |
showTotal | To display the total number and range | function(total, range) | - | |
simple | Whether to use simple mode | boolean | - | |
size | Specify the size of Pagination , can be set to small |
default | small |
default |
|
total | Total number of data items | number | 0 | |
onChange | Called when the page number or pageSize is changed, and it takes the resulting page number and pageSize as its arguments |
function(page, pageSize) | - | |
onShowSizeChange | Called when pageSize is changed |
function(current, size) | - |