设置,表示需要显示的内容,用逗号分隔,布局元素会依次显示。prev表示上一页,next为下一页,pager表示页码列表,除此以外还提供了jumpertotalsize和特殊的布局符号->->后的元素会靠右显示,jumper表示跳页元素,total表示总条目数,size用于设置每页显示的页码数量。

    设置最大页码按钮数

    Pagination 分页 - 图2

    默认情况下,当总页数超过 7 页时,Pagination 会折叠多余的页码按钮。通过pager-count属性可以设置最大页码按钮数。

    1. <el-pagination
    2. :page-size="20"
    3. :pager-count="11"
    4. :total="1000">
    5. </el-pagination>

    带有背景色的分页

    设置background属性可以为分页按钮添加背景色。

    在空间有限的情况下,可以使用简单的小型分页。

    只需要一个small属性,它接受一个,默认为false,设为true即可启用。

    1. <el-pagination
    2. small
    3. layout="prev, pager, next"
    4. :total="50">
    5. </el-pagination>

    附加功能

    Pagination 分页 - 图5

    此例是一个完整的用例,使用了size-changecurrent-change事件来处理页码大小和当前页变动时候触发的事件。page-sizes接受一个整型数组,数组元素为展示的选择每页显示个数的选项,[100, 200, 300, 400]表示四个选项,每页显示 100 个,200 个,300 个或者 400 个。

    当只有一页时隐藏分页

    当只有一页时,通过设置 hide-on-single-page 属性来隐藏分页。

    1. <div>
    2. <el-switch v-model="value">
    3. </el-switch>
    4. <el-pagination
    5. :hide-on-single-page="value"
    6. layout="prev, pager, next">
    7. </el-pagination>
    8. <script>
    9. export default {
    10. data() {
    11. return {
    12. value: false
    13. }
    14. }
    15. }

    Events

    Slot