单选按钮互斥完全依赖name属性分组,同一组内所有radio必须name值完全一致(大小写、空格、拼写均敏感),否则无法互斥;name不同则为独立组,可各自单选。

单选按钮必须用 name 属性分组
单选按钮()能否互斥选择,完全取决于它们是否共享同一个 name 值。浏览器只把 name 相同的 radio 元素视为一组,同一时刻仅允许选中其中一个。
常见错误是只设 id 或只设 value,却漏掉 name,结果所有按钮都能同时被选中——这不是 bug,是没分组。
-
name值必须是字符串,建议用有意义的英文(如"gender"、"theme"),避免空格或特殊字符 - 同一组 radio 的
name必须完全一致(大小写敏感) -
name可以和id不同,也不必和后端字段名强绑定,但提交时表单数据的键名就是这个name
多个单选组共存时的 name 写法
一个页面可以有任意多组单选按钮,只要每组使用不同的 name。比如用户要选“城市”和“偏好”,就得用两个独立的 name:
<label><input type="radio" name="city" value="bj"> 北京</label><br><label><input type="radio" name="city" value="sh"> 上海</label><br><label><input type="radio" name="preference" value="dark"> 暗色主题</label><br><label><input type="radio" name="preference" value="light"> 浅色主题</label>
注意:city 和 preference 是两组,互不影响;但若误写成 name="City" 和 name="city",就变成两组了(大小写不同)。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
为什么 name 不能用变量或动态值?
HTML 中 name 是静态属性,浏览器解析时即确定分组逻辑。如果用 JS 动态改 name(比如 el.name = 'newGroup'),已有选中状态不会自动重置,新旧按钮也不会自动合并或拆分组——这会破坏预期行为。
- 动态场景下,应提前规划好分组逻辑,用固定
name+ 条件渲染(如 Vue/React 中控制是否插入某组 radio) - 不要依赖 JS 修改
name来“临时切换分组”,容易导致表单提交时丢失值或逻辑错乱 - 服务端接收时,也按
name键取值,所以前后端约定的name字符串必须稳定
检查分组是否生效的最快方法
打开浏览器开发者工具,在 Elements 面板里选中任意一个 radio 元素,看它的 name 属性值;再点其他疑似同组的 radio,确认它们的 name 完全一致。然后手动点击测试:同一组内是否只能选一个?如果能多选,八成是 name 拼错、大小写不一致,或者某些 radio 根本没写 name。
最容易被忽略的是:复制粘贴代码时,漏掉了某个 radio 的 name 属性,或者用了中文引号、全角字符导致属性未被识别。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










