ant-design/components/pagination/index.en-US.md
afc163 e027cbec1c
docs: format all markdown (#38629)
* chore: add prettier-ignore in markdown demo

* docs: format markdown api table

* docs: format markdown api table
2022-11-17 17:31:26 +08:00

2.7 KiB

category group title cover demo
Components Navigation Pagination https://gw.alipayobjects.com/zos/alicdn/1vqv2bj68/Pagination.svg
cols
2

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

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) -