Layui表格如何合并单元格(行合并或列合并)

老萱君_6106

老萱君_6106

2026-04-30

934人浏览

原创

Layui.table 不支持 cols 中的 rowspan/colspan,需在 done 回调中用 layui.$ 手动合并:遍历 tr,按字段值连续相同统计行数,首行设 rowspan,后续同行对应 td 设 display:none。

layui.table.render 里用 cols 配置 rowspan 和 colspan 不生效?

因为 layui 的表格(layui.table)本身不支持原生的 html rowspan/colspan 渲染,所有列配置里的 rowspan 或 colspan 字段会被忽略——这不是你写错了,是框架压根没实现这个能力。

真正能合并单元格的方式只有一种:靠 done 回调 + 原生 DOM 操作手动合并。Layui 渲染完表格后,它生成的是标准的 <table> 结构,这时你才有机会用 JS 控制 <code>td 的属性。

  • 必须等 done 执行完毕再操作 DOM,否则 tbody 还没渲染出来
  • 不要在 init 阶段或 parseData 里尝试改配置项,无效
  • 合并逻辑要自己判断哪几行/列数据相同,Layui 不提供自动分组合并

怎么在 done 里安全合并行(比如按某字段相同就纵向合并)

核心思路是:遍历 tbody tr,统计连续相同值的行数,然后给首行设 rowspan,其余行用 display: none 隐藏对应单元格(不能直接删,会破坏 Layui 内部索引)。

注意:只对目标列操作,其他列保持不变;且必须用 layui.$(不是 jQuery),避免冲突。

  • 用 layui.$(elem).find('tbody tr') 获取真实渲染后的行节点
  • 从第 0 行开始循环,用 data-index 属性定位原始数据索引(Layui 自动加的)
  • 合并前先保存原始 td 内容,避免被隐藏后取不到值
  • 设 rowspan 后,记得把后续行对应 td 的 style.display = 'none'
done: function(res, curr, count) {
  const $ = layui.$;
  const tbody = $(this.elem).find('tbody');
  const rows = tbody.find('tr');
  let i = 0;
  while (i  1) {
      const targetTd = current.find('td').eq(1); // 第二列(索引1)
      targetTd.attr('rowspan', rowspan);
      for (let k = 1; k 

<h3>列合并(横向合并)为什么更难、也更少用</h3>
<p>列合并本质是让多个 <code>td</code> 横向融合成一个,但 Layui 表格每行 <code>td</code> 数量严格对应 <code>cols</code> 配置长度,强行删或合会导致样式错位、鼠标悬停异常、甚至排序/筛选功能失效。</p>
<p>真有横向聚合需求(比如表头「销售额」下分「线上」「线下」两列),应该走表头分组,而不是合并单元格:</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/code/7535" title="深蓝色网站后台管理系统layui框架模板-AdminPro"><img
														src="https://img.php.cn/upload/webcode/000/287/557/6340dac18f876183.png" alt="深蓝色网站后台管理系统layui框架模板-AdminPro" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/code/7535" title="深蓝色网站后台管理系统layui框架模板-AdminPro" class="overflowclass">深蓝色网站后台管理系统layui框架模板-AdminPro</a>
													<p class="overflowclass">一款深蓝色网站后台管理系统layui框架模板</p>
												</div>
												<a rel="nofollow" href="/xiazai/code/7535" title="深蓝色网站后台管理系统layui框架模板-AdminPro" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
  • 在 cols 里用嵌套数组定义二级表头:[[{title:'销售额', colspan:2}, {title:'订单数', colspan:1}], [{field:'online', title:'线上'}, {field:'offline', title:'线下'}, {field:'count', title:'总数'}]]
  • 这种写法由 Layui 原生支持,不会出兼容问题
  • 不要试图在 done 里给 th 加 colspan,容易和内部列宽计算冲突

合并后排序、搜索、分页还正常吗

只要没动 res.data 原始结构,只是操作了渲染后的 DOM,排序、搜索、分页都照常工作——因为这些功能全依赖数据层,和界面是否合并无关。

但要注意两个实际影响:

  • 导出 Excel(如果用了 table.exportFile)时,合并效果不会保留,导出的是原始数据结构
  • 响应式模式下(skin: 'line' 或小屏),display: none 的单元格可能造成高度塌陷,建议加 vertical-align: middle 兜底

最麻烦的其实是后续维护:别人接手代码时,很难一眼看出哪里做了 DOM 合并,尤其是没有注释 done 里的操作目的。留个 // 合并 category 列:rowspan 逻辑 很有必要。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2463

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5343

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6370

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5978

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

843

5

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

4071

6

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

2024.03.06

7008

6

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

2025.12.30

814

19

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

2025.12.30

694

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.9万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.1万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习