跳到主要内容
前端术语库

单选框

Radio

UI 组件也叫:单选按钮、单选钮、Radio Button、单选组

一句话:一组圆形的选项,只能选中其中一个,选了新的会自动取消原来的,适合 2~5 个互斥选项。

详细解释

单选框总是成组出现,一组里只能选中一项:选了「按月付」,「按年付」就自动取消。每个选项是左边一个小圆圈、右边一段文字,选中时圆圈中间出现实心圆点。一组单选框通常有一个默认选中项,选中后不能再点一次取消。

它和 复选框 的区别是只能单选,形状是圆的而不是方的;和 下拉选择 相比,单选框把所有选项平铺出来,用户不用点开就能对比,适合 2~5 个选项。只有开和关两种状态、并且立即生效的设置用 开关。选项做成几个并排的切换按钮样式时,通常叫 分段控制器。

示例

灰度线框示意,只表达结构,不代表具体视觉风格。

怎么跟 AI 说

可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。

「付款周期」用一组横向排列的单选框:按月付、按季付、按年付,默认选中按年付,并在它后面加一个「省 20%」的小标签。选中项圆圈内显示实心圆点、文字加粗,点击文字也能选中,用键盘方向键可以在选项间切换。

结构与适用场景

结构描述

由一组小圆圈加文字标签组成,选中项的圆圈中间是实心圆点,同组选项共用一个名称来保证互斥。

适用场景

  • 2~5 个互斥选项,希望用户不用点开就能看到并对比全部选项
  • 需要有一个明确默认值的单项选择,比如配送方式、付款周期
  • 每个选项需要配一行说明文字,比如选择套餐、选择配送方式

不适用场景

  • 可以同时选多个的选项,应该用复选框
  • 选项超过 6 个、平铺太占空间时,应该用下拉选择
  • 只有开和关两种状态、改完立即生效时,应该用开关

常见坏用法

  • 一组单选框没有默认选中项,用户不选就提交导致报错
  • 只有「是 / 否」且立即生效的设置用两个单选框,其实一个开关就够了
  • 同一组单选框的名称没设成一致,结果能同时选中好几个

识别特征

  • 文字左边的小圆圈,选中的圆圈中间有实心圆点
  • 多个选项横向或纵向成组排列,只有一个是选中状态
  • 带说明的单选常做成可点击的卡片,选中的卡片边框加深

DOM 线索

插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。

  • input[type="radio"]
  • [role="radio"]
  • .ant-radio-wrapper
  • .el-radio
  • [class*="MuiRadio-root"]
  • .arco-radio
  • .t-radio
  • .n-radio
  • [data-slot="radio-group-item"]