layui数据表格怎么设置多级表头

陌丽君_5100

陌丽君_5100

2026-09-03

907人浏览

原创

layui table.render()不支持真正多级表头,仅靠二维cols数组+colspan模拟两级表头;rowspan无效,fixed列必须置于首行,reload不更新表头需destroy后重render,复杂场景应在done回调中手动重写thead并保留data-field属性。

layui数据表格怎么设置多级表头

layui 的 table.render() 原生不支持真正意义上的多级表头,所谓“两级”只是靠 cols 二维数组 + colspan 模拟出来的视觉效果,rowspan 在绝大多数版本中完全无效。

cols 必须是严格二维数组,且行间列数要对齐

Layui 只认两层结构:cols: [ [第一行], [第二行] ]。任何三维、children 或扁平写法都会被忽略或降级为单级表头。

  • 第一行用于顶层标题,靠 colspan 合并列(如 {title: '用户', colspan: 2})
  • 第二行必须是具体字段列,个数必须等于第一行所有 colspan 值之和(比如 colspan: 2 + colspan: 3 = 5,那第二行就得刚好 5 个对象)
  • 第二行每个列都必须有 field(哪怕只是占位),否则报 Cannot read property 'field' of undefined
  • 第二行不能写 colspan 或 rowspan,写了也不解析,还可能导致后续列丢失

fixed 列必须放在第一行对应位置

如果你用了 fixed: 'left',它必须出现在第一行的某个列配置里,而不是第二行。否则排序图标错位、点击无响应——因为 Layui 的固定列锚点只基于首行 DOM 结构计算。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
  • 错误写法:cols: [[{title:'用户'}], [{field:'name', fixed:'left'}]] → 固定失效
  • 正确写法:cols: [[{title:'用户', fixed:'left'}, {title:'订单'}], [{field:'name'}, {field:'id'}]]
  • 如果固定列属于子列(如“用户 > 姓名”),只能把 fixed 写在第一行对应合并列上,第二行字段列不参与 fixed 定位

表头更新不能靠 reload,得 destroy 后重 render

table.reload() 不会重建表头 DOM,改了 cols 数组再 reload,界面毫无反应。

  • 唯一可靠方式是先调 table.destroy('myTable'),再完整执行一次 table.render()
  • 销毁前务必手动保存当前页码、排序字段、筛选条件等状态,否则重绘后回到第 1 页且全部清空
  • Vue/React 响应式绑定 cols 也无效,Layui 不监听数组变更

复杂场景直接在 done 回调里重写 thead

当需要三级以上表头、自定义样式、IE11 兼容或带 toolbar 时,二维 cols 已经力不从心,最稳的做法是放弃原生渲染,在 done 回调里用 jQuery 替换 <thead>。 <ul> <li>先让 layui 渲染出默认单级表头,拿到 <code>$('table[lay-id="myTable"] thead')

  • 构造新 HTML,关键要保留所有 data-field 和 data-key 属性(排序/导出全靠它)
  • 示例:<tr> <th colspan="2">用户</th> <th colspan="2">订单</th> </tr> <tr> <th data-field="name">姓名</th> <th data-field="age">年龄</th> <th data-field="id">ID</th> <th data-field="amount">金额</th> </tr>
  • 执行 $thead.html(newHtml) 后,立刻调 table.resize('myTable'),否则滚动时列宽错位
  • 最容易被忽略的是:所有叶子列(即最终绑定数据的列)必须显式设 width,minWidth 不足以约束多级表头下的列宽;另外,导出 Excel 时 colspan 完全不生效,需用 SheetJS 手动构建 !merges 区域。

    相关文章

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

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

    下载

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

    相关专题

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

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

    2023.08.11

    2263

    5

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

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

    2023.10.09

    4883

    6

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

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

    2024.03.19

    5990

    13

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

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

    2024.03.22

    5478

    10

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

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

    2024.05.22

    783

    5

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

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

    2023.10.23

    3771

    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

    6368

    6

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

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

    2025.12.30

    774

    19

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

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

    2025.12.30

    674

    12

    热门下载

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

    精品课程

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

    共87课时 | 12.7万人学习

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

    共89课时 | 10.9万人学习

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

    共5课时 | 1.6万人学习