Table 表格组件实现

基于Table标签的展现数据组件。

Table 组件主要特色在于：

• 组件 data 的解耦，减小重复代码；
• 良好的扩展性，能够经过自定义列模板来适应不一样的业务场景。

---

1. 实例

代码

<fat-table :data="tableData">
    <template slot-scope="{ item }">
        <fat-table-column label="姓名">{{ item.name }}</fat-table-column>
        <fat-table-column label="日期">{{ item.date }}</fat-table-column>
        <fat-table-column label="地址">{{ item.address }}</fat-table-column>
    </template>
</fat-table>
<!-- 自定义列模板 -->
<fat-table :data="tableData">
    <template slot-scope="{ item }">
        <fat-table-column label="头像">
            <fat-hover-tip type="right-center">
                <template slot="hover-part">{{ item.name }}</template>
                <template slot="tip-part">
                    <img src="/static/img/gakki.jpg" alt="示意图">
                </template>
            </fat-hover-tip>
        </fat-table-column>

        <fat-table-column label="地址">{{ item.address }}</fat-table-column>
        
        <fat-table-column label="操做">
            <fat-button class="btn" type="primary" size="mini" @click="$message({ content: '编辑' })">编辑</fat-button>
            <fat-button class="btn" type="primary" size="mini" @click="$message({ content: '删除' })">删除</fat-button>
        </fat-table-column>
    </template>
</fat-table>
复制代码

实例地址：Table 实例

代码地址：Github UI-Library

2. 原理

Table 组件的基本结构以下

主要可分为两个部分：

• 表格头（Table-head）：包裹在 <thead> 标签内，用于定义了一组定义表格的列头；
• 表格内容（Table-body）：包裹在 <tbody> 标签内，用于定义表格的内容。

首先实现Table-body，再依据其对应 label 来生成Table-head。

Table-body 表格内容：

<template>
  <table :class="['table-wrapper', { 'is-stripe': stripe }]">
    <thead>
      ...
    </thead>
    <!-- Table-body -->
    <tbody class="table-body-wrapper">
      <tr v-for="(item, index) in data" :key="index" :data-index="index" class="tr-wrapper">
        <slot v-bind:item="item"></slot>
      </tr>
    </tbody>
  </table>
</template>

<script> export default { props: { data: { type: Array, default: () => [] }, align: { type: String, default: "left" }, stripe: { type: Boolean, default: false } }, provide() { return { fatTable: this }; }, ... }; </script>
复制代码

组件的 prop 中包含所需数据 data ，利用 v-for="(item, index) in data" 指令生成每一行 tr，再经过 slot-scope 来生成每一项的内容，此时的数据流变为

具体使用时，只须要利用 slot-scope 来传递这个数据便可

<fat-table :data="tableData">
    <template slot-scope="{ item }">
        <fat-table-column label="姓名">{{ item.name }}</fat-table-column>
    </template>
</fat-table>
复制代码

这样使得每个 table-column 均可以被自定义，而后能够拓展成为模板。

Table-head 表格头：

因为每一个 fat-table-column 都有 label 属性，利用这个 prop 来生成 Table-head，在Table组件中 provide 当前组件用于子组件的访问

provide() {
    return {
        fatTable: this
    };
}
复制代码

同时 fat-table-column 组件的实现

<template>
  <td class="td-wrapper c-size-m">
    <slot>无</slot>
  </td>
</template>
<script> export default { props: { label: { type: String, required: true } }, inject: ["fatTable"], created() { this.$nextTick(() => { let dom = this.$el.parentNode; let index = null; while (dom.tagName !== "TR") { dom = dom.parentNode; } index = dom.getAttribute("data-index"); if (index === "0") { this.fatTable.addLabel(this.label); this.$destroy = () => { this.fatTable.delLabel(this.label); }; } }); } }; </script>
复制代码

当组件 create 时，判断是否为第一行，若是是，则调用 this.fatTable.addLabel(this.label) ，通知父组件须要添加当前 label 到Table组件的 head 中，同时定义当组件 destroy 时， 删除对应 label。

this.$destroy = () => {
    this.fatTable.delLabel(this.label);
};
复制代码

在Table组件中，定义 addLable 以及 delLabel 的处理方法

addLabel(label) {
    const { labels } = this;
    const existItem = labels.find(item => item.label === label);
    // 利用 colspan 来处理合并表头的状况
    if (existItem) {
        existItem.colspan += 1;
    } else {
        labels.push({
          label,
          colspan: 1
        });
    }
},
delLabel(label) {
    this.labels = this.labels.filter(item => item.label !== label);
}
复制代码

3. 结论

利用 Vue 提供的一些插槽属性以及 provide 、 inject 来实现 Table 组件，虽然功能不够强大，可是具有良好地可扩展性，可进一步封装所需组件。

原创声明： 该文章为原创文章，转载请注明出处。