layui form.val 给 checkbox 赋值需传数组且 value 必须严格匹配：name 相同、值为字符串/数字数组、类型一致，并在 form.render('checkbox') 后调用，否则无反应。
layui form.val 给 checkbox 赋值时为什么没反应？
因为 form.val 默认只认 name 相同的 checkbox 组，且要求传入的是数组（哪怕只有一个被选中），传字符串、布尔值或单个值都会静默失败。
常见错误现象：form.val('example', { 'agree': true }) 或 form.val('example', { 'agree': 'on' }) —— 页面 checkbox 完全无变化，控制台也无报错。
- 必须确保所有 checkbox 共享同一个
name属性（如name="agree"） - 赋值时，键名必须与
name一致，值必须是数组（如['on', 'other']），数组元素需严格匹配对应 checkbox 的value - 如果 checkbox 没设
value，浏览器默认为"on"，此时赋值数组里就得写['on']；但强烈建议显式设置value，避免歧义
如何用 form.val 正确初始化多个 checkbox？
场景：表单编辑页回填用户之前勾选的权限项（如 read、write、delete）。
HTML 结构示例：
<input type="checkbox" name="perms" value="read" title="查看"> <input type="checkbox" name="perms" value="write" title="编辑"> <input type="checkbox" name="perms" value="delete" title="删除">
JS 赋值示例：
form.val('demo', {
'perms': ['read', 'delete'] // ✅ 正确：传数组，元素与 value 完全一致
});
- 若后端返回的是布尔字段（如
{read: true, write: false, delete: true}），需手动转换：Object.keys(data).filter(k => data[k]).map(k => k) - 若 checkbox 的
value是数字（如value="1"），赋值数组里必须用字符串['1']或数字[1]—— layui 内部用===匹配，类型必须一致 - 赋值后记得调用
form.render('checkbox')（尤其在异步加载数据后），否则 UI 不更新
form.val 对未渲染的 checkbox 无效怎么办？
常见于动态插入 DOM 或 tab 切换后懒加载的表单区域：调用 form.val 时，目标 checkbox 还没被 layui 的 form.render() 处理过，导致找不到节点。
- 确保在
form.render()执行**之后**再调用form.val - 如果是 tab 页，不要在 tab 初始化前就赋值；应在
element.on('tab(xxx)', ...)回调里，先form.render('checkbox', 'xxx-form')，再form.val(...) - 检查是否误将 checkbox 放在
layui-form-pane外，或父容器有display: none—— layui 会跳过不可见区域的渲染和赋值
为什么 checkbox 值对不上后端？前后端 value 设计要统一
最容易被忽略的点：前端 value 和后端存储/接口约定不一致。比如后端存的是 1/0，前端 checkbox 却写了 value="true"，赋值时传 ['1'] 就永远不生效。
- 前后端必须约定好 checkbox 的
value字符串形式（推荐用语义化字符串如"publish"，而非数字或布尔字符串） - 调试时用
console.log($('input[name="xxx"]:checked').map((i, e) => e.value).get())看实际选中值，比猜更可靠 - form.val 的赋值逻辑不校验 value 是否真实存在，传了不存在的值不会报错，只是不勾选 —— 所以务必核对 DOM 中每个 checkbox 的
value属性
