radio分组只取决于name属性值逐字符相等:大小写敏感、无前后空格、下划线与连字符不通用;name不一致则无法互斥,提交时仅选中项生效;动态渲染需确保name绑定同一变量,禁用动态拼接;label须显式关联input以保障可访问性。

name属性必须完全一致才能分组
radio分组不靠class、id或位置,只看name属性值是否**逐字符相等**:大小写敏感、不能有前后空格、不能混用下划线和连字符。比如name="theme"和name="Theme"是两组,name="user_type"和name="user-type"也互不相干。
常见错误现象:
– 点击一个 radio,同名的其他项没取消选中
– 表单提交后后端收不到值,或只收到最后一个被点过的值
– document.querySelectorAll('input[name="xxx"]')返回数量不对,甚至为空
- 动态渲染(如 Vue 的
v-for或 React 的map)时,确保每个name绑定的是同一个字符串变量,别写成name={`opt_${i}`}这类会分裂的表达式 - 服务端接收字段名必须和前端
name完全一致,比如前端用name="payment_method",后端就不能按paymentMethod去取 - 没写
name的 radio 是“孤儿”,永远无法与其他 radio 互斥,也永远不会出现在表单提交数据里
label绑定失效?不是分组问题,但影响可用性
radio 能互斥,不代表用户能方便点中——如果 label 没正确关联,点击文字不会触发选择,容易误判为“分组失败”。这不是分组逻辑出错,而是可访问性和交互体验断层。
推荐做法:
– 把 input 直接包进 label 里:
– 或显式用 for 和 id 关联:
- 避免
label和input分开写且无任何关联 - 禁止多个 radio 共用同一个
id,这违反 HTML 规范,JS 查询和屏幕阅读器都会出错 - 移动端热区小?单纯包裹
label不一定生效,尤其遇到display: flex或重置样式时,优先用for/id显式绑定
多组 radio 必须用不同 name,哪怕语义接近
不同业务含义的选项,即使看起来“都是设置项”,也绝不能共用 name。比如主题模式(theme)和语言偏好(lang)必须分开,否则选了“深色”就自动取消“English”,这是严重逻辑错误。
常见混淆场景:
– 用户注册页的“性别”和“是否公开性别”都用了 name="gender"
– 支付方式(payment_method)和配送方式(delivery_option)被硬塞进同一个 name
- 每组
name应具备明确业务语义,避免泛化命名如option1、choice - 同一页面内,所有
name值全局唯一;重复使用会导致前一组行为被后一组覆盖 - 用
fieldset+legend包裹多组 radio,虽不影响分组逻辑,但能提升语义结构和无障碍支持
获取选中值别遍历,直接查 :checked
用 document.querySelectorAll('input[name="xxx"]') 再循环判断 checked,既慢又容易漏 null。浏览器原生支持更精准的定位方式。
正确写法:const selected = document.querySelector('input[name="theme"]:checked')?.value;
它天然返回第一个被选中的项(符合单选逻辑),没选中时返回 null,加可选链 ?.value 就能安全取值。
- 不要用
defaultChecked判断当前状态——它只反映初始 HTML 是否带checked属性,不随用户操作更新 - JS 动态设默认选中,用
el.checked = true,而不是el.setAttribute('checked', ''),后者在旧 Safari 中可能不触发 UI 更新 - 表单提交时,只有被选中的那一个
name=value会进入 payload;没选中则整个 key 不出现——这是规范行为,不是 bug
实际开发中最容易被忽略的,是动态生成 radio 时对 name 的一致性维护——模板里写对了,JS 插入新选项时却忘了赋值 el.name,或者从旧节点 clone 时漏掉了 name 属性。这种问题肉眼几乎看不出,只能靠 querySelectorAll 数数量或 Network 面板看提交字段来暴露。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











