Layui如何监听表格内部所有Checkbox的实时选中数量

胖墨君_6813

胖墨君_6813

2026-04-11

739人浏览

原创

应使用 table.on('checkbox(filter)', callback) 监听 Layui 表格复选框,通过 table.checkStatus('id').data.length 获取当前页已选行数,确保每个表格 id 和 lay-filter 唯一,避免事件干扰与性能问题。

监听 Layui 表格内 checkbox 的实时选中数量,靠 on('checkbox') 事件

layui 表格的复选框不是普通 dom,而是通过 render 后动态生成的模拟控件,直接用 change 或 click 监听无效。必须用表格实例的内置事件系统——on('checkbox'),它在每次勾选/取消时触发,且自带当前行数据和状态。

常见错误现象:document.querySelectorAll('.layui-table input[type="checkbox"]').forEach(...) 拿不到最新状态,或监听不到渲染后新增的行;用 form.on('checkbox') 只能捕获表单级 checkbox,不适用于表格内部带 lay-skin="primary" 的行内复选框。

  • 确保表格初始化时启用了复选框列:cols: [[{type: 'checkbox'}]]
  • 监听必须绑定在 table.render() 返回的实例上,不能写在 layui.use 外部
  • on('checkbox') 回调参数是对象,含 checked(布尔)、data(整行数据)、elem(原始 checkbox DOM)

获取当前已选中行数:别遍历 checkStatus,改用 table.checkStatus 实时查

很多人误以为要手动维护一个计数器,或者每触发一次 checkbox 就去 querySelectorAll 所有已勾选项 —— 这既慢又不准,尤其在分页、重载、搜索后容易出错。

正确做法是每次事件触发时,调用 table.checkStatus 获取当前表格实例的选中状态快照,它返回的对象里 data.length 就是当前页已勾选行数;若需全量(跨页),得配合 id 和 table.cache 自行比对。

  • table.checkStatus('yourTableId') 中的 'yourTableId' 必须和 render 时传的 id 一致
  • 该方法只返回当前页可见范围内的勾选项,不会包含未渲染的其他页数据
  • 如果表格开启了 page: false(无分页),data.length 就是全部已勾选项数

注意 lay-filter 值重复导致多个表格事件互相干扰

当页面有多个 Layui 表格时,如果它们的 lay-filter 属性值相同,on('checkbox', 'xxx') 会同时响应所有表格的勾选动作,造成计数混乱或重复执行。

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

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

下载

典型表现:点 A 表格的 checkbox,B 表格的监听函数也执行了;或者两个表格共享同一个计数变量,数值翻倍。

  • 每个 table.render() 必须配唯一 id 和唯一 lay-filter
  • 事件监听写法应为:table.on('checkbox(testTable)', function(obj){...}),其中 testTable 是 lay-filter 值
  • 不要为了“省事”把多个表格共用一个 lay-filter,这是最常被忽略的耦合点

性能提醒:避免在 checkbox 事件里做重操作

on('checkbox') 触发非常频繁(比如按住 Shift 多选、全选反选),如果在里面执行 DOM 遍历、Ajax 请求、复杂计算,UI 会明显卡顿,甚至导致浏览器假死。

真实场景下,多数人只需要更新一个数字 badge 或按钮状态,没必要每次触发都查一遍全量缓存或发请求。

  • 如只需显示数量,直接用 table.checkStatus().data.length 更新 <span id="selectedCount"></span> 即可
  • 如需后续批量操作,建议把 obj.data 缓存在数组里,等用户点击「提交」时再统一处理
  • 避免在事件回调中调用 table.reload() 或重新 render(),这会引发无限循环
事情说清了就结束。真正难的不是监听,是区分“当前页选中数”和“全量选中数”,以及多个表格共存时 filter 值的隔离意识——这两点没留神,调试半天也看不出哪行代码错了。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.10.23

4151

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

7148

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

714

12

html5空格代码怎么写
html5空格代码怎么写

在HTML5中,空格不能直接通过键盘空格键实现,需使用特定代码。本合集详解常用空格写法:&nbsp;(不间断空格)、&ensp;(半个中文空格)、&emsp;(一个中文空格)及CSS的white-space属性等方法,帮助开发者精准控制页面排版,避免因空格失效导致布局错乱,适用于新手入门与实战参考。

2025.12.30

373

8

html5怎么做网站教程
html5怎么做网站教程

想从零开始学做网站?这份《HTML5怎么做网站教程》合集专为新手打造!涵盖HTML5基础语法、页面结构搭建、表单与多媒体嵌入、响应式布局及与CSS3/JavaScript协同开发等核心内容。无需编程基础,手把手教你用纯HTML5创建美观、兼容、移动端友好的现代网页。附实战案例+代码模板,快速上手,轻松迈出Web开发第一步!

2025.12.31

521

12

HTML5建模教程
HTML5建模教程

想快速掌握HTML5模板搭建?本合集汇集实用HTML5建模教程,从零基础入门到实战开发全覆盖!内容涵盖响应式布局、语义化标签、Canvas绘图、表单验证及移动端适配等核心技能,提供可直接复用的模板结构与代码示例。无需复杂配置,助你高效构建现代网页,轻松上手前端开发!

2025.12.31

338

7

html5怎么使用
html5怎么使用

想快速上手HTML5开发?本合集为你整理最实用的HTML5使用指南!涵盖HTML5基础语法、主流框架(如Bootstrap、Vue、React)集成方法,以及无需安装、直接在线编辑运行的平台推荐(如CodePen、JSFiddle)。无论你是新手还是进阶开发者,都能轻松掌握HTML5网页制作、响应式布局与交互功能开发,零配置开启高效前端编程之旅!

2025.12.31

601

20

html5怎么播放视频
html5怎么播放视频

想让网页流畅播放视频?本合集详解HTML5视频播放核心方法!涵盖<video>标签基础用法、多格式兼容(MP4/WebM/OGV)、自定义播放控件、响应式适配及常见浏览器兼容问题解决方案。无需插件,纯前端实现高清视频嵌入,助你快速打造现代化网页视频体验。

2025.12.31

538

20

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习