layui复选框的value值必须设为ID，因为表单提交仅依赖value属性传值；正确写法是，动态渲染时需确保DOM中已存在value，且name相同才能被自动聚合成数组。
layui复选框的 value 值必须设为 ID
layui 的复选框（checkbox）本身不生成额外数据，提交时只靠 <input type="checkbox"> 的 value 属性传值。如果你希望提交的是 ID，那这个 ID 就得明确写进 value 里，而不是靠 data-id 或其他自定义属性——表单原生提交时，这些属性根本不会被发送。
常见错误是这样写：
<input type="checkbox" name="items" data-id="123">
这会导致提交时该复选框完全不传值（因为没 value），或者传空字符串（浏览器默认行为）。正确写法是：
<input type="checkbox" name="items" value="123">
如果用 layui 渲染（比如通过 lay-filter），也要确保原始 HTML 或 JS 动态插入时，value 已设好 ID：
<input type="checkbox" name="items" value="123" lay-skin="primary" title="选项1">
form.on('submit') 中如何获取选中的 ID 数组
layui 的表单监听依赖 name 属性聚合同名复选框。只要多个 checkbox 的 name 相同（如 name="items"），提交时就会自动收集所有勾选项的 value 成数组。
在 form.on('submit(filterName)') 回调里，直接取 field.items 即可，它已经是字符串数组（如 ["123", "456"]）：
form.on('submit(submitDemo)', function(data){<br> console.log(data.field.items); // ['123', '456']，前提是 checkbox 的 value 是 ID 字符串<br> return false;<br>});
- 如果没勾选任何项，
data.field.items是undefined，不是空数组，使用前建议判断：Array.isArray(data.field.items) ? data.field.items : [] -
name值不能含点号（如name="item.id"），否则 layui 解析会出错，只支持字母、数字、下划线 - 后端接收时，注意这个字段可能是字符串数组，不是单个字符串（PHP 中是
$_POST['items']数组；Node.js 的body-parser也会自动转成数组）
动态渲染复选框时 value 被忽略？检查 lay-submit 触发时机
用 JS 动态生成复选框（比如从接口拉数据后拼 HTML），再调用 form.render()，但提交时发现 value 没生效——大概率是因为渲染前 DOM 已存在，而你漏掉了 value 属性，或拼接时写错了变量。
典型翻车写法：
let html = '<input type="checkbox" name="items" title="' + item.name + '">'; // 忘了加 value
正确做法是显式绑定 ID：
let html = '<input type="checkbox" name="items" value="' + item.id + '" title="' + item.name + '">';
另外注意：form.render() 不会重新解析 value，它只处理样式和事件绑定。所以 value 必须在调用 form.render() 前就写死在 DOM 上。
- 避免用
innerHTML拼接大量 checkbox，容易 XSS；优先用document.createElement+setAttribute('value', id) - 如果用模板引擎（如 artTemplate），确认变量输出没被 HTML 转义导致
value变空 - 用浏览器开发者工具检查最终 DOM，确认每个
input标签确实含有value="xxx"
后端接收不到 ID？先看请求 payload 里有没有
别急着改后端代码，先打开浏览器 Network 面板，点提交，看 Form Data 里 items 字段是否出现、值是否符合预期。这是最直接的验证方式。
常见 payload 异常情况：
- 勾选了但 Form Data 里没有
items字段 → 所有 checkbox 都没勾，或name写错了（大小写、空格、中文） - 只出现一个
items且是单个字符串（如items=123）→ 后端用了req.body.items但没处理数组，或前端只渲染了一个 checkbox -
items出现多次（如items=123&items=456）→ 正常，这是浏览器对多选 checkbox 的标准编码格式
如果 payload 正确但后端收不到，问题一定出在后端解析逻辑（比如用了 body-parser 的 extended: false，它默认不解析数组形式的键值对；需设为 true）。
真正容易被忽略的是：复选框不勾选时，整个字段根本不会出现在请求里。后端不能假设 items 一定存在，必须做空值判断，而不是直接遍历。
