# Page 分页

# Page 概述

当数据量较多时,使用分页可以快速进行数据切换。

# Page 代码演示

# 基本

基本的分页,页数过多时会自动折叠。

# 每页数量

可以切换每页显示的数量。

# 电梯

快速跳转到某一页。

# 总数

显示总共多少条数据,接受 slot 来自定义内容,默认显示共 total 条

# 迷你型

设置 sizesmall 使用迷你型,迷你型拥有普通的所有功能。

# 简洁

设置 simple 属性即可使用简洁版的分页,通过输入页码回车切换,或使用鼠标点击切换页码,或使用键盘的上下键来切换。简洁分页不能使用总数、电梯和切换数量。

# Page API

# Page props

属性 说明 类型 默认值
current 当前页码,如果需要手动切换时同步,可以使用 .sync 修饰符 Number 1
total 数据总数 Number 0
page-size 每页条数 Number 10
page-size-opts 每页条数切换的配置,需配合page-size使用
加载全部(该选项value = -1)表示不分页,请求返回所有数据。(v1.0.60)
Array [10, 20, 30, 40]
placement 条数切换弹窗的展开方向,可选值为 bottomtop String bottom
size 可选值为 small(迷你版)或不填(默认) String -
simple 简洁版 Boolean false
show-total 显示总数 Boolean false
show-elevator 显示电梯,可以快速切换到某一页 Boolean false
show-sizer 显示分页,用来改变page-size Boolean false
is-blur 只在 show-elevator 为 true 时使用,设置后电梯触发方式在输入框失去焦点时触发,默认触发方式 enter 触发 Boolean false
class-name 自定义 class 名称 String -
styles 自定义 style 样式 Object -
fastArrival 是否显示快速到达首页和尾页按钮(此属性只在v1.0.12或以上版本有效) Boolean false
show-custom 显示可输入框,用于自定义每页条数(此属性只在v1.0.20或以上版本有效) Boolean false
showSizerLabel 是否在每页条数前显示'每页显示'的label(此属性只在v1.0.25或以上版本有效) Boolean false
show-reload 是否在最后显示刷新按钮(此属性只在v1.0.41或以上版本有效) Boolean false
isLoadAll 是否在pagSizeOpts的配置的显示项中展示‘加载全部’, 表示当前不分页,一次性展示全部数据,对应的值为1 Boolean false
pageValidCheck 只在 show-elevator 为 true 时使用,设置后页面跳转的输入框内无法输入汉字、字母、符号,输入值为非法值(0或超出最大值或其他)时,不做跳转 (v1.8.1) Boolean false

# Page events

事件名 说明 返回值
on-change 页码改变的回调,返回改变后的页码 页码
on-page-size-change 切换每页条数时的回调,返回切换后的每页条数 page-size
on-reload 点击刷新按钮时触发(v1.0.41或以上版本有效) 当前页码

# Page Methods

名称 说明
clearElevator(v1.0.28) this.$refs.xxx.clearElevator()

# Page slot

名称 说明
自定义显示总数的内容