lay-verify="required"对checkbox无效，因其仅校验首个checkbox的value值而非同name组勾选数量；须用form.verify()配合jquery或原生api统计:checked数量实现“至少选一项”。
直接给同 name 的 checkbox 绑定自定义验证规则，配合 form.verify() 检查已选项数量，就能实现“至少选一项”。
为什么 lay-verify="required" 对 checkbox 无效？
因为 Layui 的内置 required 规则对 <input type="checkbox"> 只做“是否存在勾选项”的粗略判断，但实际触发逻辑依赖第一个 checkbox 的 value 值——而多数场景下这个 value 是空或无意义的，导致校验失效或误报。
- 它不关心同名组里到底有几个被勾选，只看“当前这个 input 是否有值且被选中”
- 如果所有 checkbox 的
value都为空字符串，required会认为没填，直接报错 - 哪怕你勾了三个，只要第一个 checkbox 的
value=""，它就可能跳过校验
怎么写自定义规则才能真正生效？
核心是用 jQuery（Layui 1.x）或原生 DOM API（Layui 2.x）统计同 name 下所有已勾选项的数量，而不是依赖 value 参数。
- 在
layui.use('form', ...)内、form.render()之前调用form.verify()注册规则 - 规则函数里用
$('input[name="hobby"]:checked').length（注意：若 name 含[]，必须转义为hobby\[\]） - 把
lay-verify="checkbox-required"加到任意一个 checkbox 上，或其父级<div class="layui-form-item"> <li>确保每个 checkbox 都有 <code>name属性，且值完全一致（哪怕只是占位，如name="agree"）
示例：
form.verify({
'checkbox-required': function(value, item) {
var name = item.name;
var checked = $('input[name="' + name + '"]:checked').length;
if (checked === 0) {
return '请至少选择一项';
}
}
});
容易踩的坑有哪些？
最常翻车的不是逻辑写错，而是 DOM 查询范围或时机不对。
- name 带方括号（如
hobby[]）却没转义：$('input[name="hobby[]"]:checked')查不到任何元素，必须写成$('input[name="hobby\[\]"]:checked') - 把
lay-verify错加在<label></label>或<span></span>上——它只对<input>、<select></select>、<textarea></textarea>和它们的直接父<div class="layui-form-item"> 生效 <li>动态增删 checkbox 后没重绑验证，或校验触发太早（比如在 DOM 插入前就执行了 <code>form.verify()） - 用
form.on('submit')时忘了手动检查，过度依赖lay-verify的自动触发——它只在校验目标元素 change 时跑，跨区域或多条件联动时不可靠
真正稳的做法是：去掉 lay-verify，在 form.on('submit') 里用 document.querySelectorAll('input[name="xxx"]:checked').length 直接查，不依赖 jQuery，也不受渲染时机干扰。
