layui table固定列方法 layui表格如何实现左右固定列

千强吖_9496

千强吖_9496

2026-04-17

483人浏览

原创

layui table固定列失效的常见原因:必须设置数值型height且fixed值严格为'left'或'right';禁用true/空字符串/大小写错误;左右固定列需合理排序与宽度分配;动态模板避免block布局;2.8+改用absolute模拟,IE11兼容但需注意计算时机。

layui table 固定列会失效的常见原因

固定列(fixed: 'left' 或 fixed: 'right')在 layui 2.8+ 中依赖两个前提:表格必须启用滚动(即 height 设置为数值,如 height: 400),且对应列的 fixed 值必须是字符串 'left' 或 'right' —— 写成布尔值 true、数字或空字符串都会静默失效。

常见错误现象:fixed: true 看起来写了,但列不锁定;表格没设 height,拖动横向滚动条时列跟着跑;用了 width 但没配 minWidth,小屏下错位。

  • height 必须是具体数值(如 400),不能是 'auto' 或百分比
  • fixed 只接受 'left' / 'right',大小写敏感,不能写成 'Left'
  • 左右固定列不能同时出现在同一列定义里,也不能对同一列重复设置 fixed
  • 固定列的 width 建议显式声明,否则可能被自动压缩导致内容截断

layui table 左右固定列同时使用的配置要点

可以左、右各固定一列或多列,但需注意渲染顺序和宽度分配。layui 按列定义顺序渲染,fixed: 'left' 列会从左往右堆叠,fixed: 'right' 列则从右往左堆叠 —— 所以右固定列要放在列配置数组靠后位置,否则可能被遮挡。

性能影响:每多一个固定列,table 会额外生成一组 DOM 并监听 scroll 事件,10 列以上固定会明显卡顿;兼容性上,IE11 及以下不支持 position: sticky,而 layui 2.7+ 的固定列已弃用 sticky 改用绝对定位模拟,所以 IE 仍可工作,但需确保父容器 overflow: hidden 不被意外覆盖。

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

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

下载
  • 左固定列建议只设 1–2 列,右固定列同理,避免横向空间不足
  • 所有固定列的 width 总和不能超过表格总宽度,否则触发横向滚动,固定效果变差
  • 若用 cols: [[...]] 多级表头,固定属性必须写在叶子列(最内层数组的列项)上
  • 动态重载表格(table.reload())后,固定列状态不会丢失,但若传入新 cols 未带 fixed,会退化为普通列

固定列内容被截断或错位怎么办

典型表现是文字显示不全、图标错位、复选框偏移 —— 这往往不是 CSS 覆盖问题,而是固定列单元格未正确继承 table-cell 行为或高度塌陷。layui 在渲染固定列时会复制原始 <td> 并包裹进新容器,若原始列用了 <code>templet 返回带 display: block 的结构,就容易撑高或挤窄。

解决核心是让固定列单元格保持“行内盒”特性,并与主表对齐。不要在 templet 里写 <div style="display:block"> 包裹内容;也不要在列配置中加 <code>style: 'height: 36px;' 这类硬编码高度。

  • 优先用 cellMinWidth 控制最小宽度,比 width 更适应内容伸缩
  • 自定义模板中避免使用 flex 布局或绝对定位,改用 display: inline-flex 或纯 padding 对齐
  • 如果用了 toolbar 或 checkbox 列,它们默认不支持 fixed,需手动在列配置中加 fixed: 'left' 并确保它排在第一列
  • 检查浏览器控制台是否有 Uncaught TypeError: Cannot read property 'offsetWidth' of null,这说明某列 DOM 尚未挂载就被计算宽高,通常因异步模板未 resolve 完毕

layui 2.8+ 与旧版 fixed 行为差异

layui 2.7.7 之前,固定列靠 position: sticky 实现,简单但兼容性差;2.8 开始改用 JavaScript 计算 + position: absolute 模拟,好处是 IE11 可用、滚动更稳定,坏处是初始化时多一次 DOM 遍历,且对动态列宽响应稍慢。

这意味着:升级后若发现固定列偶尔“闪一下”再归位,不是 bug,是计算时机问题;若你依赖旧版的 sticky 行为做自定义样式覆盖,现在得改查 .layui-table-fixed-l 和 .layui-table-fixed-r 这两个类名容器。

  • 2.8+ 中,table.resize() 会重新计算固定列位置,但不会重绘,适合窗口 resize 后调用
  • 不再支持 fixed: 'left' + width: 'auto' 组合,width 必须是数值或百分比(如 '15%')
  • 服务端分页下,固定列逻辑不受影响;但前端分页(page: false)时,若数据量极大,建议关掉固定列,避免内存占用飙升

真正难搞的是混合场景:固定列 + 树形表格 + 动态合并单元格 —— 这时候 fixed 会直接忽略,因为 layui 的固定列机制和 tree 渲染流程不兼容,得自己 patch table.js 里的 _fixedCol 方法。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2503

5

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

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

2023.10.09

5423

6

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

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

2024.03.19

6450

13

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

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

2024.03.22

6058

10

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

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

2024.05.22

863

5

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

20

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

0

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

0

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习