R后悔药 Rue.js
  • 首页
    • 深度指南
    • 实战例子
    • 快速上手
    • 路由指南
    • 术语表
    • 错误代码参考
  • API
    • 合作伙伴
    • 插件
    • 组件库
    • 工具链
    • Text.js
    • 新闻简报
    • 常见问题
    • 团队
    • 版本发布
    • 社区指南
    • 行为规范
    • 隐私政策
  • 赞助
  • 合作伙伴
设置
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window

Radio 单选框

Radio 现在不再只是一个带颜色和尺寸的原生 input。它同时支持带说明内容的单选项、配置驱动的 Radio.Group、按钮化选项,以及更清晰的受控 / 非受控 API。

何时使用

  • 需要在少量、彼此可直接比较的选项中选出唯一结果。
  • 需要用配置数组快速生成单选组,而不是手写重复结构。
  • 希望把单选项组织成按钮组或说明卡片,但仍保持 radio 的语义。

推荐优先使用Radio.Group + options组织业务表单;手写 children 更适合定制结构和说明文案。

# 基础用法

展示原生 radio 体验,同时让受控写法更直接。

当前选择:startup

# 带说明的单选项

给 children 加一层描述结构,就可以把 Radio 组织成卡片式选项。

当前选择:team

# Radio.Group 配置模式

options 是推荐写法,适合 schema、配置表单和动态渲染。

当前计费周期:monthly

# 按钮样式

Radio.Button 是 Radio 的按钮糖衣,组内也可以统一切到按钮风格。

Outline

Solid

当前组合:comfortable / classic

# 尺寸

展示基础 xs 到 xl 的尺寸层,并补充 small / middle / medium / large 别名。

# 颜色

使用颜色修饰,同时能作为按钮组选中色复用。

neutral
primary
secondary
accent
success
warning
info
error

# 禁用状态

单项和整组都支持禁用,组禁用时会向下同步到所有 input。

# 自定义颜色

如果需要品牌色或语义强化,仍然可以直接叠加 Tailwind 工具类。

API

Radio.Button等价于Radio optionType="button"。推荐在配置驱动场景下优先使用Radio.Group的options入口。

Radio / Radio.Button

属性说明类型默认值
buttonStyle按钮形态下的视觉风格,Radio.Button 或 optionType="button" 时生效'outline' | 'solid''outline'
checked受控选中状态boolean-
className默认模式作用于 input,按钮模式作用于按钮表面string-
color选中点或按钮激活色'neutral' | 'primary' | 'secondary' | 'accent' | 'success' | 'warning' | 'info' | 'error'-
contentClassName包裹 children 内容区域的类名string-
defaultChecked非受控初始选中状态booleanfalse
disabled禁用单个选项booleanfalse
onChange值变化时回调,返回 event 和 { checked, value, optionType }(event, meta) => void-
onCheckedChange仅关心 checked 布尔值时使用(checked, event) => void-
optionType切换为默认圆点形态或按钮形态'default' | 'button''default'
rootClassName外层 label 容器类名,适合做卡片式单选项string-
size尺寸,支持 xs 到 xl 以及 small / middle / medium / large 别名'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'small' | 'middle' | 'medium' | 'large'-
value选项值,供 Group 或业务状态比较使用string | number | boolean-

Radio.Group

属性说明类型默认值
block让选项按容器宽度伸展,适合卡片或按钮组booleanfalse
buttonStyle按钮组的视觉风格'outline' | 'solid''outline'
color组选中态的默认颜色,可被单个 option 覆盖'neutral' | 'primary' | 'secondary' | 'accent' | 'success' | 'warning' | 'info' | 'error'-
defaultValue非受控默认值string | number | boolean-
disabled禁用整个单选组booleanfalse
name组内 input 的 name;未传时会自动生成string自动生成
onChange组选中值变化时回调,返回 nextValue、event 和 meta(value, event, meta) => void-
options推荐的配置化写法,适合表单 schema 或配置驱动页面Array<RadioOption | string | number | boolean>-
optionType统一控制组内是默认单选点还是按钮风格'default' | 'button''default'
orientation排列方向,优先级高于 vertical'horizontal' | 'vertical''horizontal'
size组选项默认尺寸,options 模式最适合统一控制'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'small' | 'middle' | 'medium' | 'large'-
value受控当前值string | number | boolean-
vertical纵向排列快捷开关booleanfalse

RadioOption

属性说明类型默认值
className选项外层类名,适合做卡片边框、间距等布局样式string-
color单独覆盖某个选项的选中色'neutral' | 'primary' | 'secondary' | 'accent' | 'success' | 'warning' | 'info' | 'error'-
disabled禁用当前选项booleanfalse
id透传到 input 的 idstring-
label选项展示内容,支持字符串或 JSX 结构any-
onChange该选项被选中时的局部回调(event, meta) => void-
required透传到 input 的 requiredbooleanfalse
size单独覆盖某个选项的尺寸'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'small' | 'middle' | 'medium' | 'large'-
style选项外层样式对象CSSProperties-
title透传到外层 label 的 titlestring-
value选项值string | number | boolean-
页内导航
页内导航
文档
  • 深度指南
  • 实战例子
  • 快速上手
  • 术语表
  • 错误码参照表
关于
  • 常见问题
  • 团队
  • 版本发布
  • 社区指南
生态
  • 插件
  • 组件库
  • 路由指南
  • Text.js
© 2024-2026 Xiangmin Liu
Rue.JS