单选按钮必须使用相同的name属性才能实现互斥选择,name值需完全一致(含大小写和空格),且至少一个应设checked;value应为后端可解析的标识符,JS获取选中值应使用document.querySelector('input[name="xxx"]:checked')。

单选按钮必须用相同的 name 属性才能互斥
浏览器只靠 name 判断哪些单选按钮属于同一组。如果每个 input type="radio" 的 name 值不同,它们就各自独立,无法实现“选一个、其他自动取消”的效果。
常见错误是复制粘贴时漏改 name,或者误用 id 代替 name——id 只用于关联 label 或 JS 操作,不影响单选逻辑。
-
name值必须完全一致(包括大小写和空格) - 至少一个选项应带
checked属性,否则初始无选中项 - 推荐为每个
input配套label,点击文字也能触发选择
正确写法:用 label 包裹或通过 for 关联
直接包裹最稳妥,避免 id 冲突或拼写错误:
<label><input type="radio" name="gender" value="male"> 男</label><br><label><input type="radio" name="gender" value="female"> 女</label><br><label><input type="radio" name="gender" value="other" checked> 其他</label>
如果用显式 for,确保 label 的 for 值与对应 input 的 id 完全匹配:
立即学习“前端免费学习笔记(深入)”;
<input type="radio" id="opt1" name="theme" value="dark"><br><label for="opt1">深色模式</label>
提交时后端收到的是 value 字符串,不是标签文字
表单提交后,服务器只会拿到被选中项的 value 属性值(如 "male"),而不是用户看到的“男”或“女”。所以 value 应该设计为后端可解析的标识符,而非中文或空格字符串。
- 避免
value="男",改用value="male"或value="1" - 不要省略
value——未设置时默认为空字符串,多个空value会导致后端无法区分选中了哪个 - 如果所有
value都一样,那无论点哪个,后端收到的都相同,失去分组意义
JS 获取选中值要用 document.querySelector 查 :checked
不能遍历所有 radio 然后判断 checked,更别用 getElementById——单选组没有唯一 ID。标准做法是:
const selected = document.querySelector('input[name="gender"]:checked');<br>if (selected) {<br> console.log(selected.value); // 如 "female"<br>}
注意:querySelector 返回第一个匹配项(即当前选中的那个),没选中时返回 null,必须判空。
容易忽略的是:动态插入的单选按钮,如果插入后没触发重排或没绑定事件,JS 查询可能拿不到最新状态;另外,change 事件监听要挂在父容器或委托到具体 input 上,不能只监听某个固定元素。



















