# 基本表格

用于展示多条结构类似的数据,可对数据进行排序、筛选、对比或其他自定义操作

代码

# 表格模式

# 多选

选择多行数据时使用Checkbox

page组件增加check-box属性值开启多选。 check-box :'true'

注意

这里的多选不支持跨页功能,跨页功能只能在系统按钮表单的分页中支持

代码

# 表格分页

注意

组件内目前没支持开启序号,如果有这个需求,请联系组件管理者增加type=seq开启序号列,一般数据使用时都会展示id序号。或者后端传来的seqNo字段进行显示排序
例如:
插槽里增加
<vxe-column type="seq" width="60"></vxe-column>

代码

# 合计

统计表格列数据,在列最下方进行统计数据。(前端根据列数统计)

代码

# 树形/树形

树表格与展开行同时使用,非常简单就能实现很复杂的树形展开行

树形加载

不支持(lazy)懒加载模式

代码

# 链接地址

可以将表格每行的字段变成一个链接地址,可以通过点击链接进行链接需要查看的数据地址

代码

# 工具栏

可以用于控制每个字段是否显示在表格中

代码

注意

当前组件不支持合并单元格

# 组件参数

参数名称 参数说明 是否必填 数据类型 备注
table-list 表格数据 Array
header 表格字段对象 Array 详见下面说明
select 表格是否带有复选框 Boolean
sumData 合计对象 Object 详见下面说明
mergeFields 需要合并单元格字段对象 Array 详见下面说明
rowClick 表格行点击事件 function 三个参数,分别为行对象、列对象、事件
cellClick 表格单元格点击事件 function 四个参数,分别为行对象、列对象、单元格、事件
selectionChange 表格复选框勾选事件 function 一个参数,为勾选的行数据
objectSpanMethod 表格行列合并方法 function 详见下面说明

# 表格字段参数

// 示例
      header: [
        { prop: "name", label: "名称" },
        {
          prop: "age",
          label: "年龄",
          formatter: (row) => {
            return row.age + 1;
          },
        },
        {
          label: "地址",
          children: [
            {
              label: "省份",
              children: [{
                label: "市区", 
                prop: "adress"
              }],
            },
          ],
        },
        {
          label: "操作",
          render: (h, data) => {
            return (
              <el-button type="primary" onClick={() => this.edit(data.row)}>
                编辑
              </el-button>
            );
          },
        },
      ],
参数名称 参数说明 是否必填 数据类型 备注
prop 字段存储值 String
label 字段显示值 String
formatter 用来格式化内容 Function(row, column,cellValue, index) 四个参数,分别为行对象、列对象、单元格数据及下标
children 多级表头对象 Array 可以多级嵌套,目前支持三级表头
render render构造器 Function 使用jsx语法实现自定义列

# 字段合计对象

//示例
sumData: {
    type:"sum",
    sumField:['d']
};
// type:表尾类型,目前支持合计 sumField:需要计算的字段

# 字段合并对象

//示例
mergeFields: [
    {name:"w",index:1},
    {name:"x",index:2},
    {name:"d",index:3}
],
//数组对象数据格式,name:字段 index:当前列字段的下标(注意:若表格含有勾选框,此时下标应为包含勾选框后列下标)
/**
*传数组对象组件默认合并相同行与列,但会有某个单元格与相邻列单元格相同并且也和相邻行单元格相同情
况,此时不能使用组件默认合并方法,否则会出现表格样式错乱情况
*组件提供合并方法,带有四个参数,分别是行对象、列对象、行下标、列下标,使用此方法时,
mergeFields对象须为空,否则会走组件默认合并方法
*/