Vue-Ant Design Pro of Vue-数据表格组件S-Table的使用(一)
Table 表格是我们平时在中后台系统中用到最多的组件之一了。在Ant Design Vue中,官方提供了一个Table 表格组件。我们先来介绍一下这个组件Table 表格组件https://vue.ant.design/components/table-cn基础用法分页组件,部分字段高亮特殊显示等等。详细使用请查阅文档。筛选排序当然也可以在列表上方做常规搜索,会在后面的S-Tab...
Table 表格是我们平时在中后台系统中用到最多的组件之一了。在Ant Design Vue中,官方提供了一个Table 表格组件。我们先来介绍一下这个组件
Table 表格组件
https://vue.ant.design/components/table-cn
- 基础用法
分页组件,部分字段高亮特殊显示等等。详细使用请查阅文档。
- 筛选排序
当然也可以在列表上方做常规搜索,会在后面的S-Table组件中进行说明
- 其它用法
用法非常多,包括单元格可编辑,树形数据展示,嵌套子表格,选择和操作,自定义选择项等等。我们着重介绍S-Table组件的使用
S-Table组件
基础的使用方式与 API 与 官方版(Table) 版本一致,在其基础上,封装了加载数据的方法。
你无需在你是用表格的页面进行分页逻辑处理,仅需向 Table 组件传递绑定 :data=“Promise” 对象即可。
来一个简单的例子:
<template>
<s-table
ref="table"
size="default"
:rowKey="(record) => record.data.id"
:columns="columns"
:data="loadData"
:rowSelection="{ selectedRowKeys: selectedRowKeys, onChange: onSelectChange }"
>
</s-table>
</template>
<script>
import { STable } from '@/components'
export default {
components: {
STable
},
data() {
return {
columns: [
{
title: '规则编号',
dataIndex: 'no'
},
{
title: '描述',
dataIndex: 'description'
},
{
title: '服务调用次数',
dataIndex: 'callNo',
sorter: true,
needTotal: true,
customRender: (text) => text + ' 次'
},
{
title: '状态',
dataIndex: 'status',
needTotal: true
},
{
title: '更新时间',
dataIndex: 'updatedAt',
sorter: true
}
],
// 查询条件参数
queryParam: {},
// 加载数据方法 必须为 Promise 对象
loadData: parameter => {
return this.$http.get('/service', {
params: Object.assign(parameter, this.queryParam)
}).then(res => {
return res.result
})
},
selectedRowKeys: [],
selectedRows: []
}
},
methods: {
onSelectChange (selectedRowKeys, selectedRows) {
this.selectedRowKeys = selectedRowKeys
this.selectedRows = selectedRows
}
}
}
</script>
注意:
在前后端交互的时候,后端的返回数据需按照一定格式,下面我贴一个后端返回的JSON例子(此例子和上述的例子无关):
{
"message": "",
"result": {
"data": [{
id: 1,
title: 'Alipay',
description: '那是一种内在的东西, 他们到达不了,也无法触及的',
status: 1,
updatedAt: '2018-07-26 00:00:00'
},
{
id: 2,
title: 'Angular',
description: '希望是一个好东西,也许是最好的,好东西是不会消亡的',
status: 1,
updatedAt: '2018-07-26 00:00:00'
},
{
id: 3,
title: 'Ant Design',
description: '城镇中有那么多的酒馆,她却偏偏走进了我的酒馆',
status: 1,
updatedAt: '2018-07-26 00:00:00'
},
{
id: 4,
title: 'Ant Design Pro',
description: '那时候我只会想自己想要什么,从不想自己拥有什么',
status: 1,
updatedAt: '2018-07-26 00:00:00'
},
{
id: 5,
title: 'Bootstrap',
description: '凛冬将至',
status: 1,
updatedAt: '2018-07-26 00:00:00'
},
{
id: 6,
title: 'Vue',
description: '生命就像一盒巧克力,结果往往出人意料',
status: 1,
updatedAt: '2018-07-26 00:00:00'
}
],
"pageSize": 10,
"pageNo": 0,
"totalPage": 6,
"totalCount": 57
},
"status": 200,
"timestamp": 1534955098193
}
我们可以看到后面的几个返回参数:
"pageSize": 10,
"pageNo": 0,
"totalPage": 6,
"totalCount": 57
如果你使用了S-Table组件或者Ant Design Vue中的Table组件,分页参数请务必按照以上几个参数进行返回,如果你没有对Table组件的分页部分的js源码进行修改。
注意:
修改 @/components/table/index.js 第 139 行起
result.then(r => {
this.localPagination = Object.assign({}, this.localPagination, {
current: r.pageNo, // 返回结果中的当前分页数
total: r.totalCount, // 返回结果中的总记录数
showSizeChanger: this.showSizeChanger,
pageSize: (pagination && pagination.pageSize) ||
this.localPagination.pageSize
})
// 为防止删除数据后导致页面当前页面数据长度为 0 ,自动翻页到上一页
if (r.data.length === 0 && this.localPagination.current !== 1) {
this.localPagination.current--
this.loadData()
return
}
// 这里用于判断接口是否有返回 r.totalCount 或 this.showPagination = false
// 当情况满足时,表示数据不满足分页大小,关闭 table 分页功能
(!this.showPagination || !r.totalCount && this.showPagination === 'auto') && (this.localPagination = false)
this.localDataSource = r.data // 返回结果中的数组数据
this.localLoading = false
})
(需要注意的是,这里的修改是全局性的,意味着整个项目所有使用该 table 组件都需要遵守这个返回结果定义的字段。)
这就是关于S-Table组件的基础使用。
搜索demo
<template>
<a-card
style="margin-top: 24px"
:bordered="false"
:tabList="tabList"
:activeTabKey="activeTabKey"
@tabChange="(key) => {this.activeTabKey = key}"
@click="check"
:is=""
>
<div class="table-page-search-wrapper">
<a-form
layout="inline"
:form="form"
@submit="search"
>
<a-row :gutter="48">
<a-col :md="5" :sm="24">
<a-form-item
label="售卖状态"
>
<a-select
v-decorator="[
'goods_state',
{rules: [{ required: false, message: '请选择售卖状态' }]}
]"
placeholder="全部" name="goods_state">
<a-select-option value="">全部</a-select-option>
<a-select-option value="1">在售中</a-select-option>
<a-select-option value="2">已下架</a-select-option>
</a-select>
</a-form-item>
</a-col>
</a-row>
...
...
<a-row :gutter="48">
<a-col :md="8" :sm="24">
<span class="table-page-search-submitButtons">
<a-button type="primary" html-type="submit">查询</a-button>
<a-button style="margin-left: 8px" @click="reset">重置</a-button>
</span>
</a-col>
</a-row>
</a-form>
</div>
<s-table
ref="stable"
size="default"
rowKey="key"
:columns="columns"
:showPagination=true
:rowSelection="{ selectedRowKeys: selectedRowKeys, onChange: onSelectChange }"
:data="loadData"
>
</s-table>
</a-card>
</template>
下面的方法
reset () {
this.form.resetFields()
this.reload()
},
search (e) {
e.preventDefault();
this.form.validateFields((err, values) => {
if (!err) {
this.queryParam={
goods_state:values.goods_state,
};
setTimeout(() => {
this.$refs.stable.refresh() // refresh() 不传参默认值 false 不刷新到分页第一页
}, 1000)
}
});
}
关于过滤filters的使用
<s-table
ref="stable"
size="default"
rowKey="key"
:columns="columns"
:showPagination=true
:rowSelection="{ selectedRowKeys: selectedRowKeys, onChange: onSelectChange }"
:data="loadData"
>
...
...
<!--这个地方需要使用过滤的话单独写,无需则自动渲染返回数据-->
<span slot="goods_state" slot-scope="goods_state">
<a-badge :status="goods_state | statusTypeFilter" :text="goods_state | statusFilter" />
</span>
...
...
</s-table>
<script>
const statusMap = {
1: {
status: 'success',
text: '在售中'
},
2: {
status: 'error',
text: '已下架'
}
}
...
...
filters: {
statusFilter (goods_state) {
return statusMap[goods_state].text
},
},
</script>
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)