单选框
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"]