Layui表格怎么实现根据屏幕分辨率自动切换显示列数

千强小哥_8457

千强小哥_8457

2026-03-31

690人浏览

原创

layui table 的 cols 不支持自动响应式列数切换,需手动监听 resize 或初始化时根据 clientwidth 判断并 reload;推荐用 hide 属性配合防抖 reload,避免 css 媒体查询导致错位。

layui table 的 cols 配置不支持自动响应式列数切换

layui 的 table.render() 本身没有内置「根据屏幕宽度动态增减列」的机制。所谓“自动切换列数”,实际得靠手动监听 window.onresize + 重新渲染表格,或在初始化时根据 screen.width / document.documentelement.clientwidth 做一次判断。

常见错误是直接写 cols: [[...], [...]] 然后指望它自己缩放——列会堆叠、错位甚至消失,但不会隐藏/显示某几列。

  • 真正起作用的是 cols 数组里每列的 hide 属性(布尔值),配合 table.reload()
  • 必须用 table.reload() 而不是 table.init() 或重写 DOM,否则分页、排序等状态会丢失
  • 不要在 resize 里高频调用 reload——加防抖,比如 150ms 内只执行最后一次

怎么用 screen.width 初始化不同列配置

适合「PC / 平板 / 手机」三级区分,且列结构差异固定。比如 PC 显示 6 列,平板 4 列,手机只留 2 列关键字段。

核心是把列定义拆成多个变量,再按条件选一个:

const colsPC = [[{field:'id', title:'ID'}, {field:'name', title:'姓名'}, ...]];
const colsPad = [[{field:'name', title:'姓名'}, {field:'status', title:'状态'}, ...]];
const colsMobile = [[{field:'name', title:'姓名'}, {field:'op', title:'操作', templet:'#opTpl'}]];
<p>const currentCols = screen.width </p><p>table.render({
elem: '#demo',
url: '/api/list',
cols: currentCols,
// 其他配置...
});
</p>
  • screen.width 返回设备物理像素宽度,对响应式不够准;更推荐用 document.documentElement.clientWidth
  • 如果用了服务端分页,reload() 会重新请求数据,注意传参一致性(如 where)
  • 模板列(templet)在不同分辨率下最好保持字段存在,否则可能报 Cannot read property 'xxx' of undefined

怎么监听窗口变化并动态 hide/show 列

适合列数变化不大(比如只隐藏 1–2 列)、且不想触发整表重载的场景。本质是操作列的 hide 属性 + table.reload()。

注意:Layui 的列 hide 是“渲染时生效”,所以必须 reload 才能更新视觉。

let tableIns = table.render({ /* 初始化 */ });
<p>function toggleColsByWidth() {
const w = document.documentElement.clientWidth;
table.reload('demo', {
cols: [[
{field:'id', title:'ID', hide: w </p><p>window.addEventListener('resize', debounce(toggleColsByWidth, 150));
</p>
  • table.reload() 的第一个参数是 id(即 render 时传的 elem ID),不是表格实例
  • 每次 reload 都会重绘整张表,频繁触发会影响滚动位置和焦点;若只是隐藏列,可考虑用 CSS display:none 临时 hack,但会破坏 Layui 内部列宽计算
  • 移动端 Safari 下 resize 触发不及时(比如横竖屏切换),建议补充 orientationchange 事件

为什么不用 CSS 媒体查询直接控制列显隐

因为 Layui 表格生成的 <td> 没有按字段加 class 或 data 属性,无法精准定位某列。强行写 <code>tbody td:nth-child(3) 会随列顺序、固定列、复选框列等失效。

更麻烦的是:表头(<th>)和内容(<code><td>)是分开渲染的,CSS 隐藏某列会导致表头和内容错位,且 Layui 的列宽自适应逻辑会被打乱。<ul> <li>曾有人尝试给 <code>th 加 display:none,结果点击排序时 JS 报错:Cannot read property 'field' of undefined

  • 如果用了 fixed: 'left' 或 'right',隐藏中间列会让固定列与主体列脱节,视觉撕裂
  • 唯一较稳的 CSS 方案是:只对整行(tr)做媒体查询,但这就不是“列”响应式了
  • 真要省 reload,不如把列配置做成函数,返回带 hide 的数组,然后在 render 和 reload 里复用——逻辑清晰,也避免漏掉某列的 hide 控制。

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

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

    下载

    相关标签:

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

    相关专题

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

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

    2023.08.11

    2343

    5

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

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

    2023.10.09

    5063

    6

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

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

    2024.03.19

    6150

    13

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

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

    2024.03.22

    5678

    10

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

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

    2024.05.22

    803

    5

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

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

    2023.10.23

    3891

    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

    6608

    6

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

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

    2025.12.30

    794

    19

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

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

    2025.12.30

    674

    12

    热门下载

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

    精品课程

    更多
    热门推荐
    /
    最新课程
    phpStudy极速入门视频教程
    phpStudy极速入门视频教程

    共6课时 | 54.6万人学习

    独孤九贱(4)_PHP视频教程
    独孤九贱(4)_PHP视频教程

    共89课时 | 133.4万人学习