论element-ui表格的合并行和列
0、前言
作为一个后端来写前端属实是痛苦、讲真的、刚开始我是真不想用饿了么的这个合并行和列、因为太语焉不详了、看着头疼、后来发现好像我没得选、只好硬着头皮上了。
1、element - ui 的合并行和列代码
效果图:
代码:
这里只展示关键代码
<el-table:data="tableData":span-method="objectSpanMethod"borderstyle="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、变量值展示
注:这只是某个单元格调用方法时的变量值