必须用form.verify注册自定义规则，通过item.name获取name属性，用jQuery查找同名checkbox已勾选项数量，为0时返回提示；HTML中所有checkbox需统一name且不能为空。
layui.form.verify 里怎么写 Checkbox 至少选一个的校验规则
直接在 form.verify 中注册自定义规则，不能只靠 required —— 因为 checkbox 是多选控件，required 对它无效（浏览器原生不支持）。
核心是：用 jQuery 选中同 name 的所有 checkbox，检查是否至少有一个被勾选。
- 规则名建议用语义化名称，比如
checkbox-required，避免和内置规则冲突 - 验证函数返回
false表示失败，此时会弹出提示；返回true或undefined表示通过 - 注意 name 值要和 HTML 中一致，例如
<input type="checkbox" name="hobby">，规则里就得按hobby查
layui.use('form', function(){
var form = layui.form;
form.verify({
'checkbox-required': function(value, item){ // value 是第一个 checkbox 的 value，没用；真正要看的是 item 的 name
var name = item.name;
var checked = $('input[name="' + name + '"]:checked').length;
if(checked === 0){
return '请至少选择一项';
}
}
});
});
HTML 中 checkbox 怎么写才能被 form.verify 正确识别
关键点不在 type 或 value，而在于 name 属性必须统一，且每个 checkbox 都要有 name —— 否则 $('input[name="xxx"]') 找不到全部元素。
- 不要漏写
name，哪怕只是占位，比如name="agree" - value 可以为空或任意值，不影响校验逻辑，但提交时会发实际 value（空字符串也发）
- 如果某组 checkbox 是动态生成的，确保 DOM 加载完再执行
form.verify注册，否则规则可能失效 - 别用
lay-filter当校验依据，form.verify只认name
<input type="checkbox" name="role" value="admin"> 管理员<br><input type="checkbox" name="role" value="editor"> 编辑<br><input type="checkbox" name="role" value="viewer"> 查看者
为什么 form.on('submit') 里手动校验更可靠
因为 form.verify 在表单提交时触发，但它的执行时机依赖于 layui 内部对 input/change 事件的监听，而 checkbox 的 change 事件有时延迟或丢失（尤其快速连点、移动端），导致验证提前通过。
- 推荐在
form.on('submit')回调里加一层主动判断，绕过 verify 的潜在不稳定 - 直接操作 DOM 比依赖框架封装更可控，比如用
$('[name="xxx"]:checked').length - 如果同时有多个 checkbox 组要校验，可封装成函数复用，避免重复代码
- 注意：手动校验后记得
return false阻止默认提交，否则即使提示了也会发请求
form.on('submit(my-form)', function(data){
if ($('input[name="service"]:checked').length === 0) {
layer.msg('服务类型至少选一项');
return false;
}
// 继续提交...
});
遇到“总是提示未选中”该怎么排查
最常见原因是 jQuery 选择器没匹配到任何元素，也就是 name 值对不上，或者 checkbox 还没渲染进 DOM。
- 打开控制台，运行
$('input[name="your-name-here"]')，看返回长度是否符合预期 - 检查是否用了特殊字符（如点、中括号）在 name 里，需转义：
name="user[role]"要写成$('input[name="user\[role\]"]') - 如果 checkbox 是通过 AJAX 或 laytpl 渲染的，确认
form.render()已执行，否则 layui 不知道新元素存在 - IE 下
:checked伪类兼容性没问题，但若用了旧版 layui（
真正麻烦的不是写法，而是 name 和 DOM 状态的同步 —— 很多人改了 HTML 的 name 却忘了同步改 JS 里的字符串，或者渲染顺序没理清。
