HTML中直接添加checked属性是设置单选按钮初始默认值的唯一可靠方式,浏览器仅依据该属性存在与否判断选中状态,JS赋值无法定义初始值;同name组内仅首个checked生效;动态设置需用click()触发事件链;框架中应避免defaultChecked与checked混用。

直接加 checked 属性才是唯一可靠方式
浏览器只认 checked 属性是否存在,不看值、不认字符串内容。写成 checked="false" 或 checked="" 都会生效;删掉这个属性才真正“未选中”。任何用 JS 赋值 radio.checked = true 来替代 HTML 属性的做法,都无法定义“初始默认值”——DOM 渲染时,HTML 属性优先级高于 JS 属性,后者可能被覆盖。
常见错误现象:document.querySelector('input[value="pro"]').checked = true 写在 DOMContentLoaded 之后,页面看起来选中了,但表单提交时该值没被包含,因为初始状态仍为空。必须在 HTML 源码里就写好 checked。
同一 name 组里只能有一个 checked
浏览器强制同名单选按钮互斥,即使你给多个都加了 checked,也只采纳 DOM 中第一个出现的元素。这容易在模板渲染时出问题:比如 PHP 循环输出选项,条件判断漏了排他逻辑,导致两个 checked 并存,后一个永远无效。
使用场景举例:编辑用户资料页回显性别,数据库值是 "female",但模板里误写成:
<input type="radio" name="gender" value="male" checked><input type="radio" name="gender" value="female" checked>
结果永远显示“男”被选中。正确做法是仅对匹配项输出 checked:
PHP 示例:>
JS 动态设置选中状态要触发事件链
单纯赋值 radio.checked = true 不会触发 change 事件,依赖该事件的校验、联动或提交逻辑会卡住。更稳妥的做法是调用 click() 方法——它既改变状态,又模拟真实用户行为,自动触发原生事件流。
注意点:
- 确保元素已挂载到 DOM,否则
click()无效 - 避免在循环中反复调用,尤其配合 AJAX 回调时,易引发重复执行
- 若需手动 dispatch,用
radio.dispatchEvent(new Event('change', { bubbles: true })),但不如click()简洁可靠
框架中别混用 defaultChecked 和 checked
React/Vue 等框架里,defaultChecked 只在首次渲染时起作用,后续 state 变化不会更新;而 checked 是受控属性,会强制同步 DOM 状态。两者混用会导致竞态:比如服务端渲染(SSR)时写了 defaultChecked,客户端 hydration 时又绑了 checked={value === 'x'},若初始值不一致,React 会报错并降级为客户端接管,造成 UI 闪烁。
正确姿势:
- React:始终用
checked+onChange,state 初始值必须与某个value匹配 - Vue:用
v-model绑定变量,该变量值需等于某选项的value字符串 - SSR 场景下,服务端传来的初始数据必须和客户端 state 初始化完全一致
最易被忽略的是:单选组“无选中态”在 HTML 标准里不合法。如果业务需要“暂不选择”,得额外加一个 value="" 或 value="none" 的兜底选项,而不是试图用 JS 清空所有 checked。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











