layui checkbox 的值必须用 form.val() 获取最稳妥，它会自动聚合同 name 的所有 checkbox 为数组；需确保表单有 lay-filter、name 一致且含 value，并在 form.render('checkbox') 后调用。
layui checkbox 的值怎么取？直接用 form.val() 最稳
layui 表单里的 checkbox 不像单选或输入框那样能直接用 document.getElementById 拿 value，必须走 layui 的表单模块解析逻辑。否则你拿到的永远是第一个 checkbox 的原始 checked 状态，不是“用户最终勾了哪几个”。form.val() 是唯一推荐方式，它会自动聚合同 name 的所有 checkbox 为数组。
- 确保 checkbox 的
name属性一致（比如name="roles"），且每个都有value - 必须在
form.render('checkbox')之后调用（如果动态插入过 checkbox） -
form.val('yourFormFilter')返回的是一个对象，key 是 name，value 是数组（全未选时为空数组）
为什么 document.querySelectorAll('input[name="xxx"]:checked') 不可靠？
因为 layui 的 checkbox 实际渲染后，原始 input 被隐藏，真正响应点击的是外层的伪元素（.layui-form-checkbox）。原生 DOM 查询可能拿不到实时状态，尤其在使用 form.on('checkbox(filterName)') 动态切换后，DOM 的 checked 属性未必同步更新。
- 只适合调试查看，不能用于业务逻辑取值
- 在 IE 或旧版浏览器中容易返回空 NodeList
- 无法区分“用户取消勾选”和“初始就没勾选”的语义差异
监听 checkbox 变化时，回调里怎么取当前值？
用 form.on('checkbox(yourFilter)', function(data){...})，它的 data 参数自带 elem（当前触发的 checkbox DOM）、othis（jQuery 封装对象）和最关键的 value（当前这个 checkbox 的 value 值）——但注意：这只是单个 checkbox 的值，不是全部已选值。
- 要获取“全部已选项”，仍得在回调里再调一次
form.val('yourFilter') - 不要依赖
data.elem.checked，它可能滞后于 UI - 如果需要判断是勾选还是取消，看
data.elem.checked+ 对比上一次结果，或者用data.othis.next().hasClass('layui-form-checked')
常见错误：提交前发现 checkbox 值总是空数组
大概率是表单容器没加 lay-filter，或者 form.val() 调用时机不对。layui 表单模块靠 lay-filter 关联数据，没这个属性就识别不了你的表单组。
- 表单容器（如
form或div）必须有lay-filter="userForm" - 确保已执行
layui.use(['form'], function(){...})并初始化了 form 模块 - 如果 checkbox 是 JS 动态追加的，追加完要立刻执行
form.render('checkbox', 'userForm') - 别把 checkbox 放在
layui-form-item外面，否则可能被忽略
form.val()，哪怕多调一次也比后期 debug 强。
