---
category: Components
subtitle: 分页
type: 导航
title: Pagination
cols: 1
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*8y_iTJGY_aUAAAAAAAAAAAAADrJ8AQ/original
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*WM86SrBC8TsAAAAAAAAAAAAADrJ8AQ/original
---

采用分页的形式分隔长列表，每次只加载一个页面。

## API

```html
<a-pagination @change="onChange" :total="50" />
```

| 参数              | 说明                                                         | 类型                                                                           | 默认值                     | 版本  |
| ----------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------ | -------------------------- | ----- |
| current(v-model)  | 当前页数                                                     | number                                                                         | -                          |       |
| defaultPageSize   | 默认的每页条数                                               | number                                                                         | 10                         |       |
| disabled          | 禁用分页                                                     | boolean                                                                        | -                          | 1.5.0 |
| hideOnSinglePage  | 只有一页时是否隐藏分页器                                     | boolean                                                                        | false                      |       |
| itemRender        | 用于自定义页码的结构，可用于优化 SEO                         | ({page, type: 'page' \| 'prev' \| 'next', originalElement}) => vNode \| v-slot | -                          |       |
| pageSize(v-model) | 每页条数                                                     | number                                                                         | -                          |       |
| pageSizeOptions   | 指定每页可以显示多少条                                       | string\[] \| number\[]                                                         | \['10', '20', '50', '100'] |       |
| responsive        | 当 size 未指定时，根据屏幕宽度自动调整尺寸                   | boolean                                                                        | -                          | 3.1   |
| showLessItems     | 是否显示较少页面内容                                         | boolean                                                                        | false                      | 1.5.0 |
| showQuickJumper   | 是否可以快速跳转至某页                                       | boolean                                                                        | false                      |       |
| showSizeChanger   | 是否展示 `pageSize` 切换器，当 `total` 大于 50 时默认为 true | boolean                                                                        | -                          |       |
| showTotal         | 用于显示数据总量和当前数据顺序                               | Function(total, range)                                                         | -                          |       |
| simple            | 当添加该属性时，显示为简单分页                               | boolean                                                                        | -                          |       |
| size              | 当为「small」时，是小尺寸分页                                | string                                                                         | ""                         |       |
| total             | 数据总数                                                     | number                                                                         | 0                          |       |

### 事件

| 事件名称       | 说明                                                       | 回调参数                 |      |
| -------------- | ---------------------------------------------------------- | ------------------------ | ---- |
| change         | 页码或 `pageSize` 改变的回调，参数是改变后的页码及每页条数 | Function(page, pageSize) | noop |
| showSizeChange | pageSize 变化的回调                                        | Function(current, size)  | noop |
