欢迎进入jdb电子官方网站!

咨询热线:400-156-4567

论element-ui表格的合并行和列(巨细节)

发布时间:2024-01-19 16:04:47

论element-ui表格的合并行和列

0、前言

​ 作为一个后端来写前端属实是痛苦、讲真的、刚开始我是真不想用饿了么的这个合并行和列、因为太语焉不详了、看着头疼、后来发现好像我没得选、只好硬着头皮上了。

1、element - ui 的合并行和列代码

效果图:

代码:

这里只展示关键代码

<el-table
:data="tableData"
:span-method="objectSpanMethod"
border
style="width: 100%; margin-top: 20px">
    <el-table-column
        prop="id"
        label="ID"
        width="180">
    </el-table-column>
    <el-table-column
        prop="name"
        label="姓名">
    </el-table-column>
    <el-table-column
        prop="amount1"
        label="数值 1(元)">
    </el-table-column>
    <el-table-column
        prop="amount2"
        label="数值 2(元)">
    </el-table-column>
    <el-table-column
        prop="amount3"
        label="数值 3(元)">
    </el-table-column>
</el-table>
objectSpanMethod({ row, column, rowIndex, columnIndex }) {
        if (columnIndex === 0) {
          if (rowIndex % 2 === 0) {
            return {
              rowspan: 2,
              colspan: 1
            };
          } else {
            return {
              rowspan: 0,
              colspan: 0
            };
          }
        }

先看看它们是怎么完成这个的:

首先,看似是合并了行、实际上是让某些行的指定单元个内容不显示,照成了合并的假象,即如上述例子、实际上是有 5 行内容、然后将行的第一列两两合并(就是在这两行中只显示第一行内容,第二行内容被隐藏了),其余列不变、形成合并的假象。

再来分析代码:

​ 分析代码前先搞明白其中的变量有什么用

:span-method="objectSpanMethod"
// 这是在table标签中定义的一个变量,变量值是一个方法,用这个方法去处理然后完成行列合并

2、变量解释

objectSpanMethod({ row, column, rowIndex, columnIndex })
// 由它给的文档我们可以知道、方法会被固定传入一个对象,对象中有上述 4 个变量,其作用是:
/*
	row: 获取此行的全部数据,即你需要传入且展示的数据
	column:获取列的结构及其数据、注意此时列的数据不是指我们传入的数据、而是饿了么自己定义的列结构。
	rowIndex:行号,这个行号表示当前是第几行
	columnIndex:列号,表示当前是第几列
*/
// 相信我虽然解释了变量意义,但是你还是不明白、因为我还有东西没解释。。。

3、方法运行解释

:span-method="objectSpanMethod"
...
objectSpanMethod({ row, column, rowIndex, columnIndex }) {
    ...
}

整个方法的运行:

​ 当表格需要进行合并时、整个渲染方式就发生了变化、之前可以看作以行为单位、一行一行渲染、而当你使用了 :span-method="objectSpanMethod" 变量后、渲染方式则改为一个单元格一个单元格渲染,即这个方法 objectSpanMethod 需要执行的次数是:列的个数 * 行数。

​ 也就是说、它会按照这样的格式去调用方法:(行值,列结构值,行号,列号),具体例子为:

(row, column, 0, 0)、(row, column, 0, 1)、(row, column, 0, 2)、(row, column, 0, 3)、(row, column, 0, 4)

(row, column, 1, 0)、(row, column, 1, 1)、(row, column, 1, 2)、(row, column, 1, 3)、(row, column, 1, 4)

这里括号中的内容表示每一次调用方法 objectSpanMethod 会传入的参数内容,因为前两个参数是由我们实际值决定的,所以先统一使用变量代替。

这样调用有什么用呢?看方法内的代码

if (columnIndex === 0) {  // columnIndex:表示是第几 列 
    if (rowIndex % 2 === 0) { // rowIndex:表示是第几行
        return {
            rowspan: 2,		// 2:需要合并的行数
            colspan: 1		// 1:需要合并的列数
        };
    } else {
        return {
            rowspan: 0,     // 0:只要是0,都代表着不显示
            colspan: 0
        };
    }

看不太懂是吧?不急、接下来详细解释。

1、进入if

​ 因为方法调用是有 4 个参数的、前两个可以先不用看,主要看后两个、观察、想要方法中的第一个 if 执行,我们就必须让 columnIndex = 0 才行、也就是说只要当列号为 0 时,就会执行 if 中的内容,这有啥用呢?因为上述例子是想将第一列的内容两行两行合并,所以我们首先得找到列的位置、也就是索引 0

2、第二个 if

​ 一起理解,第二个 if 的作用是:当行号为 0,2 时,即除以 2 的余数为 0。我们会返回 两个变量,其值为 2 ,1、反之、则返回0、0

有什么用?

​ (2,1):表示将自身以及下一行合并,即合并 2 行、将自身的列合并(如果值是 2 那么就是将自身和右边的一起合并)

我们知道了 2,1 的作用、但还有一个没说、也就是自身所处的行和列位置,显而易见、方法的参数早已把这两个值给我们了。

所以完整理解就是,如果方法参数是:(row, column, 0(行号), 0(列号)) 、那么需要将第 1 行(自身)和第 2 行合并、将第 1列(自身)合并。(0:表示第 1 行,1:表示第 2 行)

但是此时又有个问题了,如果将 1 ,2行合并,那么应该同时有两个ID值在同一行内、但是我们希望只有一个才行、因此需要用到 第二个 if 中的 else 中内容,即 0,0

rowspan: 0, colspan: 0 :结合自身行列号数与(0,0)、整体意思就是说:将处于第 2 行 ,第 1 列的值隐藏,

如此,便做到了只显示一个ID又合并了两个单元格

那如果我想将姓名这一列也做和ID列的同样处理怎么办?

只需要将 if 中的判断条件添加一个,即:

if (columnIndex === 0 || columnIndex === 1) {  // columnIndex:表示是第几 列 
    ...
    }

这样,当方法执行到姓名列时,也会做合并处理。

2、如果是动态数据怎么办?

有时候开发中、我每一次需要合并的行数是不一定相同的、第一个需要合并3行,第二个需要合并6行甚至更多,那怎么办?

回顾一下我们是怎么控制行列合并的?

if (columnIndex === 0) {  // columnIndex:表示是第几 列 
    ===================================================
    =if (rowIndex % 2 === 0) { // rowIndex:表示是第几行=
    ===================================================
        return {
            ======================================
            =	rowspan: 2,	// 2:需要合并的行数    =
            ======================================    
            colspan: 1		// 1:需要合并的列数
        };
    } else {
        return {
            rowspan: 0,     // 0:只要是0,都代表着不显示
            colspan: 0
        };
    }

很显然、我们只需要知道每一次合并的行个数即可,那怎么求呢?

我们开发中后端会给一个数组data我们,这个数组的长度就代表我们需要显示的行数(不考虑合并时),此时我们需要将姓名相同的行进行合并,可以这样做:

return中定义两个变量(我使用的是vue,你们可按需改变,本意思定义全局变量)spanArr:[], // 需要合并的行数
      	pos:0,// 索引

getSpanArr(data) {
    // 遍历数据
    for (let i = 0; i < data.length; i++) {
        // 如果是第一个数据,就将列表spanArr添加一个1,表示暂时只有一个名字相同的、且将索引pos赋值为0
        if (i === 0) {
            this.spanArr.push(1);
            this.pos = 0
        } else {
            // 判断当前元素与上一个元素是否相同
            if (data[i].name === data[i - 1].name) {
                // 如果相同就将索引为 pos 的值加一
                this.spanArr[this.pos] += 1;
                // 且将数组添加 0 
                this.spanArr.push(0);
            } else {
                // 如果元素不同了,就可以通过索引为 pos 的值知晓应该需要合并的行数
                // 同时,我们再次添加一个值1,表示重新开始判断重复姓名的次数
                this.spanArr.push(1);
                // 同时 索引加一
                this.pos = i;
            }
        }
    }
    console.log("索引数组:")
    console.log(this.spanArr)
},
===================
/*
spanArr最终的值格式是:
[3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0, 3, 0, 0]
3代表需要合并的行数,0代表此单元格需要被隐藏(当然这个作用会在`objectSpanMethod` 方法中体现,现在只是准备数据)
*/
    
    objectSpanMethod({ row, column, rowIndex, columnIndex }){

    /* 此方法总共运行次数与有几列几行有关,如果有5列30行,那么都是从0开始作为第一行第一列,
      (行,列):0,0 0,1 0,2 0,3 0,4 0,5 1,0...*/
    // 0,1,5表示需要处理 第 1,2,5列的行进行合并处理
    if (columnIndex === 0 || columnIndex === 1 || columnIndex === 5) {
        /* 
        将需要合并的行数赋值给 _row,注意这里由上一个方法的输出可以知道,这里的值可以是 3或者0
        当为 3 时,表示将当下的第 rowIndex+1 行与第 columnIndex+1 列所指向的单元格向下合并 _row 格
        当为 0 时,表示将当下的第 rowIndex+1 行与第 columnIndex+1 列所指向的单元格隐藏
        */
        const _row = this.spanArr[rowIndex];
        const _col = _row > 0 ? 1 : 0;
        return {
            rowspan: _row,
            colspan: _col
        }
    }


},

最终结果:

3、变量值展示

注:这只是某个单元格调用方法时的变量值