Ant Design Vue(v1.7.8)a-table组件的插槽功能

Ant Design Vue(v1.7.8)a-table组件的插槽功能_第1张图片

本案例中,编写了一个名为stockAdd的vue(v2.5.17)自定义组件,使用a-table组件的插槽功能,创建了一个可编辑的数据表格:

Ant Design Vue(v1.7.8)a-table组件的插槽功能_第2张图片

表格用于添加采购的物品,点“新增物品”按键,表格添加一行,新增的行内容为空。

一、a-table组件基本操作

a-table组件实现表格框架和数据填充,接收columns和data-source两个参数:

columns内容为数组:

    columns () {
      return [{
        title: '物品名称',
        dataIndex: 'name',
        scopedSlots: {customRender: 'nameShow'}
      }, {
        title: '所属类型',
        dataIndex: 'typeId',
        width: 200,
        scopedSlots: {customRender: 'typeIdShow'}
      }, {
        title: '型号',
        dataIndex: 'type',
        scopedSlots: {customRender: 'typeShow'}
      }, {
        title: '采购量',
        dataIndex: 'amount',
        scopedSlots: {customRender: 'amountShow'}
      }, {
        title: '消耗量',
        dataIndex: 'consumption',
        scopedSlots: {customRender: 'consumptionShow'}
      }, {
        title: '单位',
        dataIndex: 'unit',
        scopedSlots: {customRender: 'unitShow'}
      }, {
        title: '单价',
        dataIndex: 'price',
        scopedSlots: {customRender: 'priceShow'}
      }]
    }

数组中每一项代表一列,每列各个属性的具体含义为:

参数 说明 类型 默认值 版本
dataIndex 列数据在数据项中对应的 key,支持 a.b.c 的嵌套写法 string -
customRender 生成复杂数据的渲染函数,参数分别为当前行的值,当前行数据,行索引,@return 里面可以设置表格行/列合并,可参考 demo 表格行/列合并 Function(text, record, index) {}|slot-scope -
title 列头显示文字 string|slot -
width 列宽度 string|number -
scopedSlots 使用 columns 时,可以通过该属性配置支持 slot-scope 的属性,如 scopedSlots: { customRender: 'XXX'} object -

上面是官方解释,通俗描述为:

title——显示在列头(每列第一行)的文字标题,表面这一列数据是什么内容,如物品名称、单位、单价等

dataIndex——该列数据在data-source传入数组dataList  [{name:"白菜", price:"4.00"},{name:"土豆", price:"2.50"}]  的一个数据项(表示一行)中 的键值对的键名(key)。如物品名称列的dataIndex为 'name',表示该列的每行数据是dataList中每个数据项的name对应的取值,第一行数据是白菜,第二行是土豆,依次类推。

Ant Design Vue(v1.7.8)a-table组件的插槽功能_第3张图片

scopedSlots: {customRender: 'nameShow'}——表示该列的样式是一个名为nameShow的插槽:

Ant Design Vue(v1.7.8)a-table组件的插槽功能_第4张图片

:data-source="dataList"绑定的是行数据项数组,其结构为:

[{name: '白菜', type: '', typeId: '', unit: '', amount: 0, consumption: 0, price: 0},

{name: '土豆', type: '', typeId: '', unit: '', amount: 0, consumption: 0, price: 0},

{name: '物品名称', type: '', typeId: '', unit: '', amount: 0, consumption: 0, price: 0}]

每行对应数组的一项,每行数据含有若干 以列的dataIndex为键名的键值对,键值对数量等于列的数量。

Ant Design Vue(v1.7.8)a-table组件的插槽功能_第5张图片

键为name的是物品名称列的数据

键为type的是型号列的数据

键为typeId的是所属类型列的数据

键为unit的是单位列的数据

键为amount的是采购量列的数据

键为consumption的是消耗量列的数据

键为price的是单价列的数据(图里标的是价格列,改不了 不改了)

二、a-table组件内的插槽

不加插槽的话,a-table组件显示的数据表是只读的。想要变成交互式的输入框,需要使用具名作用域插槽。在stockAdd组件中(本例中的最顶层组件),定义的dataList数组的数据需要传递到a-table组件,以及我们为a-table组件添加的插槽中。

数据传递路径:stockAdd组件 ——》a-table组件 ——》具名作用域插槽

Ant Design Vue(v1.7.8)a-table组件的插槽功能_第6张图片

注意:虽然插槽的定义在stockAdd组件中,但结构上插槽是a-table组件的子组件(stockAdd组件的孙组件),插槽不能直接获取stockAdd组件中定义的数据。

因为 a-table组件的结构不像自定义组件那样方便查看,这里不去深究a-table组件源码如何实现插槽。插槽从a-table组件接收参数需要使用slot-scope属性,slot-scope="text, record"是固定写法,探究a-table源码超出本例的实用原则,有精力再研究。