分页组件常见于管理系统的列表查询页面,数据量巨大时需要分页的操作。
当数据量过多时,使用分页分解数据。
1.如何使用?
/*设置layout,表示需要显示的内容,用逗号分隔,布局元素会依次显示。prev表示上一页,next为下一页,pager表示页码列表,除此以外还提供了jumper和total,size和特殊的布局符号->,->后的元素会靠右显示,jumper表示跳页元素,total表示总条目数,size用于设置每页显示的页码数量。*/<div class="block"><span class="demonstration">页数较少时的效果</span><el-paginationlayout="prev, pager, next":total="50"></el-pagination>
</div>
<div class="block"><span class="demonstration">大于 7 页时的效果</span><el-paginationlayout="prev, pager, next":total="1000"></el-pagination>
</div>
2.设置最大页码按钮数
//默认情况下,当总页数超过 7 页时,Pagination 会折叠多余的页码按钮。通过pager-count属性可以设置最大页码按钮数。<el-pagination:page-size="20":pager-count="11"layout="prev, pager, next":total="1000">
</el-pagination>
3.带有背景色的分页
//设置background属性可以为分页按钮添加背景色。<el-paginationbackgroundlayout="prev, pager, next":total="1000">
</el-pagination>
4.小型分页
在空间有限的情况下,可以使用简单的小型分页。
//只需要一个small属性,它接受一个Boolean,默认为false,设为true即可启用。<el-paginationsmalllayout="prev, pager, next":total="50">
</el-pagination>
5.附加功能
根据场景需要,可以添加其他功能模块。
/*使用了size-change和current-change事件来处理页码大小和当前页变动时候触发的事件。page-sizes接受一个整型数组,数组元素为展示的选择每页显示个数的选项,[100, 200, 300, 400]表示四个选项,每页显示 100 个,200 个,300 个或者 400 个。*/<template><div class="block"><span class="demonstration">显示总数</span><el-pagination@size-change="handleSizeChange"@current-change="handleCurrentChange":current-page.sync="currentPage1":page-size="100"layout="total, prev, pager, next":total="1000"></el-pagination></div><div class="block"><span class="demonstration">调整每页显示条数</span><el-pagination@size-change="handleSizeChange"@current-change="handleCurrentChange":current-page.sync="currentPage2":page-sizes="[100, 200, 300, 400]":page-size="100"layout="sizes, prev, pager, next":total="1000"></el-pagination></div><div class="block"><span class="demonstration">直接前往</span><el-pagination@size-change="handleSizeChange"@current-change="handleCurrentChange":current-page.sync="currentPage3":page-size="100"layout="prev, pager, next, jumper":total="1000"></el-pagination></div><div class="block"><span class="demonstration">完整功能</span><el-pagination@size-change="handleSizeChange"@current-change="handleCurrentChange":current-page="currentPage4":page-sizes="[100, 200, 300, 400]":page-size="100"layout="total, sizes, prev, pager, next, jumper":total="400"></el-pagination></div>
</template>
<script>export default {methods: {handleSizeChange(val) {console.log(`每页 ${val} 条`);},handleCurrentChange(val) {console.log(`当前页: ${val}`);}},data() {return {currentPage1: 5,currentPage2: 5,currentPage3: 5,currentPage4: 4};}}
</script>
6.当只有一页时隐藏分页
当只有一页时,通过设置 hide-on-single-page
属性来隐藏分页。
<div><el-switch v-model="value"></el-switch><el-pagination:hide-on-single-page="value":total="5"layout="prev, pager, next">
</el-pagination>
</div><script>export default {data() {return {value: false}}}
</script>