layui全选需用form.on('checkbox(filter)', callback)监听，手动设置目标checkbox的checked属性并调用form.render('checkbox')刷新UI，避免循环触发需加标志位或手动同步样式。
layui checkbox 全选按钮怎么绑定 click 事件
layui 的 checkbox 是通过 form.render('checkbox') 渲染的，原生 DOM 的 click 事件无法直接捕获渲染后的复选框状态变化。全选按钮本身必须是独立的 checkbox（比如加 lay-filter="allChoose"），然后用 form.on('checkbox(allChoose)', callback) 监听，而不是用 jQuery 的 $().on('click')。
常见错误是给全选框加 onclick 或直接操作 checked 属性后不调用 form.render()，结果界面不更新、后续监听失效。
- 全选框必须有
lay-filter，且不能和其他普通 checkbox 共用同一个 filter - 监听回调里要手动设置所有目标 checkbox 的
checked属性，再调用form.render('checkbox')刷新 UI - 不要在回调里用
$("input[name='xxx']").prop('checked', true)后就结束——layui 不认这个，必须触发 render
如何批量操作同 name 的 checkbox 状态
layui 不提供类似 form.val('filter', {name: [...]}) 批量设值的 API，得靠 DOM 操作 + render 配合。关键点在于：目标 checkbox 必须有相同的 name 属性（如 name="ids"），全选按钮则单独命名（如 name="all"）。
示例逻辑：
form.on('checkbox(allChoose)', function(data){
var checked = data.elem.checked;
// 设置所有 name="ids" 的 checkbox
$("input[name='ids']").prop('checked', checked);
// 必须重新渲染，否则 UI 不同步、后续 form.val() 取不到新值
form.render('checkbox');
});
注意：form.render('checkbox') 会重绘所有 checkbox，如果页面 checkbox 很多，建议加节流或只渲染局部区域（用 form.render('checkbox', 'your-container-id')）。
全选状态和子项联动时怎么避免循环触发
当子 checkbox 全部勾选后自动勾选“全选”，而“全选”又控制子项——两者互相触发会导致无限递归或状态错乱。layui 的 form.on('checkbox(...)') 回调里再调 form.render() 会再次触发监听，必须拦截。
- 用一个标志位（如
isSettingAll）临时关闭子项监听逻辑 - 全选按钮回调中设子项
checked并 render，但不触发子项的监听；子项回调中判断是否“全部已选”，仅当非批量设置时才更新全选框 - 更稳妥的做法：子项变更后，用
$("input[name='ids']:checked").length === $("input[name='ids']").length计算，再用$("input[name='all']").prop('checked', ...).next('.layui-form-checkbox').removeClass('layui-form-checked').addClass(...)手动同步样式（绕过监听）
form.val() 获取不到最新 checkbox 值怎么办
form.val('filterName') 返回的是表单域初始值或最后一次 form.val() 设定的值，**不是实时 DOM 状态**。它对 checkbox 的支持依赖于正确的 name 和渲染流程。如果你改了 DOM 但没调 form.render()，或用了重复的 name，form.val() 就会返回旧值或空对象。
调试建议：
- 先确认所有 checkbox 都有正确
name且无重复 - 每次 DOM 修改后必须调
form.render('checkbox') - 想取当前真实选中值，直接用
$("input[name='ids']:checked").map(function(){return this.value;}).get()更可靠 - 如果用了 lay-filter，确保
form.on()绑定的 filter 名和form.render()调用一致
最易被忽略的是：全选按钮自己也要有 name，否则 form.val() 根本不会把它包含进去——哪怕它只是个控制开关。
