设置,表示需要显示的内容,用逗号分隔,布局元素会依次显示。prev
表示上一页,next
为下一页,pager
表示页码列表,除此以外还提供了jumper
和total
,size
和特殊的布局符号->
,->
后的元素会靠右显示,jumper
表示跳页元素,total
表示总条目数,size
用于设置每页显示的页码数量。
设置最大页码按钮数
默认情况下,当总页数超过 7 页时,Pagination 会折叠多余的页码按钮。通过pager-count
属性可以设置最大页码按钮数。
<el-pagination
:page-size="20"
:pager-count="11"
:total="1000">
</el-pagination>
带有背景色的分页
设置background
属性可以为分页按钮添加背景色。
在空间有限的情况下,可以使用简单的小型分页。
只需要一个small
属性,它接受一个,默认为false
,设为true
即可启用。
<el-pagination
small
layout="prev, pager, next"
:total="50">
</el-pagination>
附加功能
此例是一个完整的用例,使用了size-change
和current-change
事件来处理页码大小和当前页变动时候触发的事件。page-sizes
接受一个整型数组,数组元素为展示的选择每页显示个数的选项,[100, 200, 300, 400]
表示四个选项,每页显示 100 个,200 个,300 个或者 400 个。
当只有一页时隐藏分页
当只有一页时,通过设置 hide-on-single-page
属性来隐藏分页。
<div>
<el-switch v-model="value">
</el-switch>
<el-pagination
:hide-on-single-page="value"
layout="prev, pager, next">
</el-pagination>
<script>
export default {
data() {
return {
value: false
}
}
}