Layui table如何监听复选框全选和全不选的逻辑

星降

星降

2026-07-15

565人浏览

原创

必须用 table.on('checkbox(filter)') 监听,且 filter 必须与 table.render() 中的 lay-filter 值完全一致;全选/全不选共用同一回调,需结合 data.type === 'all'(或空字符串)与 data.checked 判断状态,不可仅依赖 data.type 或 data.value。

必须用 table.on('checkbox(filter)') 监听,且 filter 要和 table.render() 中的 lay-filter 值完全一致;全选/全不选都走同一个回调,靠 data.type === 'all'data.checked 判断,但不能只信 data.type

为什么 table.on('checkbox(filter)') 是唯一入口

layui 表格的复选框是渲染后动态生成的伪元素,真实 <input type="checkbox"> 被隐藏,UI 层由 <div class="layui-form-checkbox"> 模拟。原生 <code>clickchange 绑定在 DOM 上根本不会触发——你点的是外层 div,事件根本到不了 input。

  • 错误写法:$('thead input[type="checkbox"]').on('click', ...)document.querySelector(...).addEventListener('change', ...) —— 仅对首次渲染前的 DOM 有效,分页、重载、展开行后全部失效
  • 正确路径:只有 table.on('checkbox(userTable)') 这个内置事件能穿透 layui 的事件代理层,捕获所有操作(包括表头全选、单行勾选、键盘空格切换)
  • filter 必须严格匹配:比如 lay-filter="userTable",回调里就得写 table.on('checkbox(userTable)'),多一个空格、大小写不一致、或多个表格共用同一 filter 都会导致监听错乱

如何准确区分“全选”和“全不选”

data.type === 'all' 只表示操作对象是表头全选框,data.checked 才是关键布尔值:它为 true 是全选,false 是全不选。但要注意旧版 layui(2.7.x 及更早)中 data.type 可能为空字符串,不能只靠它判断。

  • 稳妥做法:先确认 data.type === 'all' || !data.type,再看 data.checked
  • 别依赖 data.value:全选框通常没设 valuedata.valueundefined,拿它做分支会出错
  • 如果表格启用了树形结构或子行展开,data.type 还可能是 'child',建议预留分支:if (data.type === 'all' || data.type === 'child')

监听到之后,千万别手动改 DOM

data.checked 是 layui 已经计算好的逻辑状态,不是原生 DOM 属性。你不需要、也不应该用 $(...).prop('checked', true) 去同步子项——这会导致 UI 和内部状态脱节,后续 table.checkStatus() 返回结果错乱。

layui手机车牌号码键盘代码
layui手机车牌号码键盘代码

layui手机车牌号码键盘代码是一款基于jQuery跟layui制作的手机端车牌号码输入弹出键盘选择,支持新能源汽车车牌输入格式代码。

下载
  • 真正要做的只有两件事:
    – 实时统计当前页已选数量:调用 table.checkStatus('userTable').data.length
    – 跨页记住选中项:把 data.data.id(单选时)或遍历 table.cache['userTable'](全选时)存进全局数组,自己维护 selectedIds
  • 全选框本身的状态(比如是否显示“半选”)需原生设置:document.querySelector('.layui-table-header input[type="checkbox"]').indeterminate = true,但必须在 table.render()done 回调里执行,否则会被 layui 下次渲染覆盖

表头全选框取消操作捕获不到?这是设计如此

table.on('checkbox(filter)') 不会触发表头全选框的点击事件——它只响应行内 checkbox 的勾选变化。表头那个“全选/全不选”动作,layui 内部直接更新了所有行状态,但不抛出独立事件。

  • 想捕获“用户点了全选框并取消”,只能监听表格容器的 click 事件,委托到表头 checkbox 区域:layui.$('#userTable').on('click', '.layui-table-header input[type="checkbox"]', ...)
  • 必须加 setTimeout(..., 0):否则读到的 checked 属性还是旧值,因为 layui 状态更新是异步的
  • 判断依据不是 DOM 属性,而是 table.checkStatus('userTable').data.length === 0,这才是真实已选数据量

最易忽略的一点:全选逻辑和表格渲染强耦合。如果你在 table.render() 外提前写了 table.on('checkbox(...)'),或者 layui.use(['table'], callback) 没包住监听代码,事件就永远绑不上——它不是静态注册,而是等表格实例创建完成后才可挂载。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

1086

5

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

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

2023.10.09

2210

6

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

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

2024.03.19

2105

13

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

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

2024.03.22

2276

10

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

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

2024.05.22

335

5

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

1096

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

317

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

993

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

890

6

热门下载

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

精品课程

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

共87课时 | 11.4万人学习

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

共89课时 | 9.7万人学习

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

共5课时 | 1.5万人学习