用 document.querySelectorAll('input[name="gender"]') 获取所有同名 radio 元素,再通过 Array.from(radios).map(radio => radio.value) 提取全部 value 值;若只需启用项,则先 filter(radio => !radio.disabled)。

用 document.querySelectorAll 获取所有 radio 元素
HTML 中的 radio 单选框通常以同名 name 分组,但每个 input[type="radio"] 是独立的 DOM 节点。要提取“所有可选的数值”,本质是拿到这一组里每个 input 的 value 属性值,不管它是否被选中。
最直接的方式是用 document.querySelectorAll 按 name 选择:
const radios = document.querySelectorAll('input[name="gender"]');
注意:必须带引号包裹 name 值,且选择器中不能漏掉 input 标签前缀,否则可能误选其他同名元素(比如 hidden input)。
常见错误是写成 document.querySelectorAll('[name="gender"]') —— 这会匹配任意带该 name 的元素,风险高。
立即学习“前端免费学习笔记(深入)”;
遍历并提取 value 属性值
拿到 NodeList 后,需逐个读取 value。注意不是 checked 状态,而是所有选项的原始值:
const values = Array.from(radios).map(radio => radio.value);
这里用 Array.from 是因为 NodeList 不支持原生 map(IE 和部分旧环境),现代浏览器虽支持,但显式转数组更稳妥。
关键点:
-
radio.value是字符串,即使 HTML 写的是数字(如value="1"),它仍是"1" - 如果某个 radio 没写
value,其value默认为"on",不是空字符串或undefined - 禁用(
disabled)的 radio 仍会被选中并返回其value,除非你主动过滤
排除 disabled 或只取启用项?按需加条件
如果业务上只关心用户能实际选择的值(即启用状态),就得过滤掉 disabled:
const enabledValues = Array.from(radios).filter(radio => !radio.disabled).map(radio => radio.value);
也可以合并成链式调用,但拆开更易读、易调试。
注意:radio.disabled 返回布尔值,不是字符串;不要写成 radio.getAttribute('disabled') !== null,那样在某些旧浏览器可能不准。
另外,radio.hasAttribute('disabled') 和 radio.disabled 行为一致,但后者更轻量、更语义化。
为什么不用 document.querySelector('input[name="x"]:checked')?
这个写法只能拿到当前被选中的那个 radio,根本拿不到“所有可选数值”。它解决的是“当前选了谁”,而不是“一共有哪几个选项”。
典型误用场景:
- 做表单初始化时想预填下拉或展示所有选项文案 → 必须取全部
value+ 对应的label - 做校验逻辑,需要确认用户输入是否在合法范围内 → 得先知道合法范围是什么
- 把 radio 配置同步到其他组件(比如 React 状态)→ 初始态需全量加载
真正需要“所有可选数值”时,:checked 完全不相关,别被名字误导。
边界情况容易忽略:name 相同但分布在不同 form 或无 form 的 radio,querySelectorAll 仍能跨区域抓取,只要在当前文档内。如果页面动态插入 radio,记得在插入后重新查询,DOM 不会自动更新 NodeList。



















