单选按钮组必须用 name 属性匹配,同组 radio 的 name 值须完全相同(如 "size"),通过 querySelectorAll('input[name="size"]:checked') 获取选中值最可靠,返回数组长度为0或1,未选中时应处理为 null 或缺失状态。

用 name 匹配单选按钮组,别靠 id 或 class 遍历
单选按钮(input[type="radio"])的“组”语义完全由 name 属性定义。浏览器只允许同名 radio 中最多一个被选中,JS 也必须按 name 去查——否则你拿到的不是一组,而是散点。
常见错误是给每个 radio 写不同 id,再用 document.getElementById() 逐个判断 checked,既难维护又漏掉动态插入的项。
- 所有同组 radio 必须有相同
name(如name="size"、name="color") -
value应为有意义的字符串("xl"、"navy"),避免空值或默认"on" - 不要用
class当分组依据:多个组可能共用 class,但name是唯一数据契约
querySelectorAll + Array.from 提取当前选中值
最稳写法是直接查已勾选的节点:document.querySelectorAll('input[name="size"]:checked')。它天然过滤掉未选中的、不同 name 的、甚至非 radio 的元素。
注意 NodeList 不是数组,不能直接调用 .map():
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
const sizeValue = Array.from(
document.querySelectorAll('input[name="size"]:checked')
).map(el => el.value)[0] || null;
- 返回数组长度恒为 0 或 1(单选特性),取
[0]安全;没选中时返回null,后端/后续逻辑得能处理 - 若用
for...of或forEach,也要先转Array.from,否则在旧环境可能报TypeError: NodeList is not iterable - IE8 及以下不支持
:checked伪类,需降级:用document.getElementsByName("size")配合循环判断el.checked
多组单选按钮怎么一次拿全?别存中间状态
电商场景常见尺寸、颜色、材质三组 radio。用户反复切换时,**不要监听每个 click 存数组**,那会累积中间值(如 ["S", "M", "L"]),而你要的是最终点击“加入购物车”那一刻的组合(如 ["M", "black", "cotton"])。
- 在提交动作触发时(比如按钮
click事件里),对每组name单独执行一次querySelectorAll(...:checked) - 封装成函数更清晰:
getRadioValue("size")、getRadioValue("color") - 避免全局变量缓存选中值——DOM 状态是最可信的源,缓存反而容易和界面脱节
为什么 getElementsByName 返回的是 NodeList 而不是数组?
document.getElementsByName("size") 返回的是 NodeList,它像数组但缺少 .map、.filter 等方法。直接 elements[0].checked 可读,但遍历时必须手动循环或转数组。
更关键的是:getElementsByName 不区分类型,会把同名的 input[type="text"] 也拉进来——所以它适合兜底,不适合精准查询。
- 首选
querySelectorAll('input[name="size"]:checked'):类型 + name + 状态三重过滤 - 若必须用
getElementsByName,记得加类型判断:el.type === "radio" && el.checked - 动态渲染的 radio(如 Vue/React 挂载后插入),要等 DOM 更新完成再查,否则
checked属性可能还是false(即使 UI 已显示选中)
name 根本不会出现在表单提交数据里——后端收不到 size=,只看到字段缺失。这个“空”不是 null,是彻底不存在。


















