Vue-Ant Design Pro of Vue-数据表格组件S-Table的使用(一)

超、凢脫俗 2022-04-25 08:24 4630阅读 0赞

Table 表格是我们平时在中后台系统中用到最多的组件之一了。在Ant Design Vue中，官方提供了一个[Table 表格][Table]组件。我们先来介绍一下这个组件

# Table 表格组件 #

https://vue.ant.design/components/table-cn

*  基础用法  
    分页组件，部分字段高亮特殊显示等等。详细使用请查阅文档。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d1X3dlbl9qaWU_size_16_color_FFFFFF_t_70]
 *  筛选排序  
    当然也可以在列表上方做常规搜索，会在后面的S-Table组件中进行说明  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d1X3dlbl9qaWU_size_16_color_FFFFFF_t_70 1]
 *  其它用法  
    用法非常多，包括单元格可编辑，树形数据展示，嵌套子表格，选择和操作，自定义选择项等等。我们着重介绍S-Table组件的使用

# S-Table组件 #

基础的使用方式与 API 与 [官方版(Table)][Table 1] 版本一致，在其基础上，封装了加载数据的方法。  
你无需在你是用表格的页面进行分页逻辑处理，仅需向 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>

[Table]: https://vue.ant.design/components/table-cn/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d1X3dlbl9qaWU_size_16_color_FFFFFF_t_70]: /images/20220125/1a06e1f3cf604329a74e8519680849f0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d1X3dlbl9qaWU_size_16_color_FFFFFF_t_70 1]: /images/20220125/6c235cff8d4f451787f5e184f952ffe3.png
[Table 1]: https://vue.ant.design/components/table-cn