2016-03-31 14:17:09 +08:00
|
|
|
---
|
|
|
|
category: Components
|
2016-09-21 11:28:38 +08:00
|
|
|
subtitle: 分页
|
2018-11-04 16:20:35 +08:00
|
|
|
type: 导航
|
2016-09-21 11:28:38 +08:00
|
|
|
title: Pagination
|
2017-02-18 18:12:38 +08:00
|
|
|
cols: 1
|
2020-06-05 13:50:09 +08:00
|
|
|
cover: https://gw.alipayobjects.com/zos/alicdn/1vqv2bj68/Pagination.svg
|
2016-03-31 14:17:09 +08:00
|
|
|
---
|
2015-06-15 22:01:39 +08:00
|
|
|
|
2015-06-26 14:42:30 +08:00
|
|
|
采用分页的形式分隔长列表,每次只加载一个页面。
|
2015-06-15 22:01:39 +08:00
|
|
|
|
2015-06-26 14:42:30 +08:00
|
|
|
## 何时使用
|
2015-06-17 20:24:42 +08:00
|
|
|
|
2015-06-26 14:42:30 +08:00
|
|
|
- 当加载/渲染所有数据将花费很多时间时;
|
|
|
|
- 可切换页码浏览数据。
|
2015-07-13 17:51:28 +08:00
|
|
|
|
|
|
|
## API
|
|
|
|
|
2019-12-26 14:37:39 +08:00
|
|
|
```jsx
|
|
|
|
<Pagination onChange={onChange} total={50} />
|
2015-09-23 14:13:31 +08:00
|
|
|
```
|
2015-07-13 17:51:28 +08:00
|
|
|
|
2019-05-10 15:38:35 +08:00
|
|
|
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
| current | 当前页数 | number | - | |
|
|
|
|
| defaultCurrent | 默认的当前页数 | number | 1 | |
|
|
|
|
| defaultPageSize | 默认的每页条数 | number | 10 | |
|
2019-11-22 10:33:34 +08:00
|
|
|
| disabled | 禁用分页 | boolean | - | |
|
|
|
|
| hideOnSinglePage | 只有一页时是否隐藏分页器 | boolean | false | |
|
2019-05-10 15:38:35 +08:00
|
|
|
| itemRender | 用于自定义页码的结构,可用于优化 SEO | (page, type: 'page' \| 'prev' \| 'next', originalElement) => React.ReactNode | - | |
|
|
|
|
| pageSize | 每页条数 | number | - | |
|
2020-06-30 13:26:37 +08:00
|
|
|
| pageSizeOptions | 指定每页可以显示多少条 | string\[] | \[`10`, `20`, `50`, `100`] | |
|
2020-01-17 18:23:58 +08:00
|
|
|
| showLessItems | 是否显示较少页面内容 | boolean | false | |
|
2020-06-30 13:26:37 +08:00
|
|
|
| showQuickJumper | 是否可以快速跳转至某页 | boolean \| { goButton: ReactNode } | false | |
|
2020-07-10 15:18:40 +08:00
|
|
|
| showSizeChanger | 是否展示 `pageSize` 切换器,当 `total` 大于 50 时默认为 true | boolean | - | |
|
2020-04-11 16:36:12 +08:00
|
|
|
| showTitle | 是否显示原生 tooltip 页码提示 | boolean | true | |
|
2020-06-30 13:26:37 +08:00
|
|
|
| showTotal | 用于显示数据总量和当前数据顺序 | function(total, range) | - | |
|
2019-05-10 15:38:35 +08:00
|
|
|
| simple | 当添加该属性时,显示为简单分页 | boolean | - | |
|
2020-06-30 13:26:37 +08:00
|
|
|
| size | 当为 `small` 时,是小尺寸分页 | `default` \| `small` | `default` | |
|
2020-03-10 20:32:34 +08:00
|
|
|
| responsive | 当 size 未指定时,根据屏幕宽度自动调整尺寸 | boolean | - | |
|
2019-05-10 15:38:35 +08:00
|
|
|
| total | 数据总数 | number | 0 | |
|
2020-06-30 13:26:37 +08:00
|
|
|
| onChange | 页码改变的回调,参数是改变后的页码及每页条数 | function(page, pageSize) | - | |
|
|
|
|
| onShowSizeChange | pageSize 变化的回调 | function(current, size) | - | |
|