前言
最近在写一个新项目,UI框架用的是Ant Design Vue
,因为之前一直用的Element UI
,没有用过这个组件库,没想到二者区别这么大,因此踩了不少坑,其中就有Table
和Pagination
,花了一会时间才弄明白,在此记录并分享一下此次经历。
注意:是 Vue3 项目。
一、Table 表格
Table
的使用相对比较简单,与Element
不同的是,它不需要写很多的标签,主要通过数据来改变列表显示。
表格的列标题和数据分别用columns
、data
两个数组来控制,命名随意。分别将其传给表格的columns
、data-source
对象即可。
注意:数组中的 key 值是有一定要求的,如 标题必须为title
,columns
的key
是data
中的值的名字等。具体的字段名称就要去看官方文档了,本文就不做赘述了。
<script setup lang='ts'>import {ref } from 'vue';const columns = ref([{title: '标题',dataIndex: 'name',key: 'name',},{title: '时间',dataIndex: 'date',key: 'date',}])const data = ref([{key: 1,name: 'Ant Design Vue表格',year: '',}])</script><template><a-table :columns="columns" :data-source="data" :pagination="pagination"></a-table></template>
上面只是正常的数据展示,但是有些时候我们需要做一些逻辑处理,比如按钮什么的,这种情况下就需要使用<template></template>
进行处理。
需要注意的是,这里需要两层<template></template>
,外面一层是一个具名插槽,需要处理的是body
,因此需要加上#bodyCell="{ column }"
。
.vue
<script setup lang='ts'>import {ref } from 'vue';const columns = ref([{title: '考核名称',dataIndex: 'name',key: 'name',}, {title: '考核名称',dataIndex: 'name',key: 'name',}, {title: '考核名称',dataIndex: 'name',key: 'name',}])const data = ref([{key: 1,name: '测试',}])</script><template><a-table :columns="columns" :data-source="data" :pagination="pagination"><template #bodyCell="{ column }"><template v-if="column.key === 'status'"><dsa-tag type="warn">已完成</dsa-tag></template><template v-else-if="column.key === 'operate'"><a class="button">编辑</a></template></template></a-table></template>
二、Pagination 分页
通过上面的代码可以发现,表格中并未使用分页组件,但是页码依然展示出来了,你可能会觉得这很方便,但实际上,这样的方式,会让很多功能都无法实现。因此,需要对分页进行定制处理。
与Table
相同,分页同样是通过数据去控制,因为表格默认已经使用了分页,所以无需额外引入。但是需要在表格上添加:pagination="pagination"
,指定控制分页的数据。
.vue
<script setup lang='ts'>import {ref } from 'vue';const pagination = ref({current: 1,defaultPageSize: 10,total: 11,showTotal: () => `共 ${11} 条`})const columns = ref([{title: '考核名称',dataIndex: 'name',key: 'name',}, {title: '考核名称',dataIndex: 'name',key: 'name',}, {title: '考核名称',dataIndex: 'name',key: 'name',}])const data = ref([{key: 1,name: '测试',}])</script><template><a-table :columns="columns" :data-source="data" :pagination="pagination"><template #bodyCell="{ column }"><template v-if="column.key === 'status'"><dsa-tag type="warn">已完成</dsa-tag></template><template v-else-if="column.key === 'operate'"><a class="button">编辑</a></template></template></a-table></template>
分页的配置项有很多,具体参考官方文档 Pagination 分页。
END