radio必须带name属性才能分组互斥,name值需完全一致(含大小写、空格、引号类型),label须正确绑定input,value不可省略且应简短合法,checked仅用于初始默认选中。

radio 必须带 name 属性,否则无法分组互斥
浏览器只靠 name 值判断哪些 input[type="radio"] 属于同一组。漏写 name,或拼错(比如 gender 写成 geneder),会导致看似同组、实则各自独立——点一个不会取消另一个,表单提交时也收不到预期数据。
常见错误写法:<input type="radio" value="male"><input type="radio" value="female">
正确写法必须显式统一:<input type="radio" name="gender" value="male"><input type="radio" name="gender" value="female">
-
name区分大小写,Gender和gender是两组 - 空格、下划线、短横线混用(如
user_typevsuser-type)也会导致分组失效 - 动态插入 radio 时,务必显式赋值
el.name = "gender",别依赖复制旧节点
label 必须与 input 正确绑定,否则点击文字无效
用户习惯点文字选中 radio,但若 label 和 input 没关联,点击就毫无反应——这不是 bug,是 HTML 规范行为。尤其在移动端,小圆圈点击困难,没 label 几乎等于不可用。
立即学习“前端免费学习笔记(深入)”;
两种合法写法:
显式绑定:<input id="opt1" type="radio" name="opt" value="a"><label for="opt1">选项A</label>
隐式包裹:<label><input type="radio" name="opt" value="a">选项A</label>
- 显式绑定时,
for值必须和input的id完全一致(含大小写) - 避免把多个 radio 包进同一个
label,否则点任意位置都会激活第一个 - 不要省略
id就用for,也不要多个 radio 共用一个id(违反唯一性)
value 不可省略,且不宜用中文或空字符串
没设 value 的 radio,提交时默认发 "on",后端极易误判。如果所有 radio 都用 value="on",根本区分不出用户选了哪一项。
常见错误:<input type="radio" name="theme" value="深色模式"><input type="radio" name="theme" value="">
-
value应简短、合法、可预测,比如"light"/"dark"、"1"/"0" - 中文
value易引发编码问题、校验失败、前后端映射错乱 - 后端接收的是
value字符串,不是label文本,两者语义需对齐
默认选中只能用 checked,且同一组仅限一个
checked 是布尔属性,写成 checked="true" 或 checked="checked" 都多余,直接写 checked 即可。它只控制初始状态,不参与运行时逻辑。
错误做法:<input type="radio" name="mode" value="dev" checked><input type="radio" name="mode" value="prod" checked>
- 同一组内最多一个
checked,多了浏览器只认第一个 - 别用
selected——那是<option></option>的属性,对 radio 无效 - JS 动态设置默认项时,应操作
el.checked = true,而非改属性字符串
真正容易被忽略的,是 name 值的“完全一致”——不只是拼写,还包括引号类型(name='x' 和 name="x" 在部分老环境里可能被当不同值)、空格、大小写、甚至模板引擎渲染时的意外换行或缩进。上线前用 document.querySelectorAll('input[type="radio"][name="xxx"]') 数一数数量,比肉眼检查靠谱得多。



















