Layui单选框重置必须先用form.val()清空值再调form.render('radio'),仅修改DOM的checked属性无效;需确保lay-filter值严格匹配,操作须在layui.use回调内执行,动态加载后须立即render,按钮type必须为button。

layui单选框重置必须配合form.render('radio')
只设input[type="radio"].checked = false或$('input[name="xxx"]').prop('checked', false)完全无效——Layui 把原生 radio 隐藏了,UI 是它自己画的伪元素,DOM 状态改了但 UI 不同步。你看到的还是旧选中态。
实操建议:
- 用
form.val('filterName', { 'fieldName': '' })清空值,其中fieldName是 radio 的name属性值 - 紧接着调
form.render('radio'),否则标题栏、勾选图标、高亮边框全都不变 - 如果页面有多个 radio 组且 filter 不同,
form.render('radio')会刷全部;想精准控制,目前无单组接口,只能确保 filter 作用域隔离
重置后仍显示旧值?检查 name 和 lay-filter 是否一致
常见现象:调了form.val('searchForm', { status: '' }),但 radio 还是原来选项。大概率是form标签的lay-filter="searchForm"和 JS 中传入的'searchForm'不一致(比如多写了空格、大小写错、短横线/下划线混用)。
实操建议:
- 打开浏览器开发者工具,确认
<form lay-filter="xxx">里的值 - JS 中必须严格匹配:
form.val('xxx', {}),不能写成'xxx '或'xxx-form' - 没写
lay-filter时,form.val(null, {})可清当前页所有已渲染 radio,但不推荐用于生产环境——太粗暴
动态加载的 radio 表单重置失败
表单是 AJAX 拼完 HTML 后插入 DOM 的,点了重置按钮,radio 看起来没反应。本质是form.render('radio')执行时,DOM 还没挂载完成,或者layui.use(['form'], ...)没包裹操作逻辑。
实操建议:
- 确保所有操作都在
layui.use(['form'], function(){ ... })回调内,否则form变量未定义 - HTML 插入 DOM 后,再调
form.render('radio');不要在字符串拼接完就立刻 render - 如果 radio 是后续追加的(比如点击“添加一行”),需在追加后立即调
form.render('radio'),否则新控件不响应
重置按钮别用 type="reset",也别漏掉 table.reload
放在<form>里的重置按钮,若写成<button>重置</button>(没声明 type),浏览器默认当type="submit"处理,可能触发表单提交或页面刷新;若写type="reset",只清原生 input,对 radio 完全无效。
实操建议:
- 按钮必须显式写
<button type="button" id="resetBtn">重置</button> - 重置逻辑末尾加
table.reload('tableId', { where: {} }),否则表格仍按旧 radio 值发起请求 - radio 若参与校验(比如必填),清空后需手动移除
layui-form-danger类,否则红边提示残留
form.val()改数据层,form.render('radio')刷 UI 层,少一步,就卡在中间状态。


















