Radio 单选框
单选框。
何时使用
- 用于在多个备选项中选中单个状态。
- 和
Select的区别是,Radio所有选项默认可见,方便用户在比较中选择,因此选项不宜过多。
基本使用
最简单的用法。
不可用
Radio不可用。
单选组合
一组互斥的Radio配合使用。
Radio.Group 垂直
垂直的Radio.Group,配合更多输入框选项。
Radio.Group 组合 - 配置方式
通过配置options参数来渲染单选框。也可通过optionType参数来设置Radio类型。
按钮样式
按钮样式的单选组合。
大小
大中小三种组合,可以和表单输入框进行对应配合。
填底的按钮样式
实色填底的单选按钮样式。
Group Option自定义label
如果使用Radio.Group的options选项想自定义label内容,则可以使用label插槽实现。
Radio Props 属性
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| buttonStyle | button的风格样式,目前有描边和填色两种风格 | outline | solid | outline | |
| checked | 指定当前是否选中 | boolean | false | |
| defaultChecked | 初始是否选中 | boolean | false | |
| disabled | 禁用 | boolean | false | |
| name | input[type="radio"]的name属性 | string | - | |
| size | button的大小 | large | middle | small | - | |
| type | radio的类型 | default | button | default | |
| value | 根据value进行比较,判断是否选中 | string | number | - |
Radio Slots 插槽
| 事件 | 说明 |
|---|---|
| default | 自定义默认内容 |
Radio.Group Props 属性
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| buttonStyle | button的风格样式,目前有描边和填色两种风格 | outline | solid | outline | |
| defaultChecked | 初始是否选中 | boolean | false | |
| disabled | 禁用 | boolean | false | |
| name | input[type="radio"]的name属性 | string | - | |
| options | 以配置形式设置子元素 | RadioGroupOption[] | - | |
| optionType | 用于设置Radio options类型 | default | button | default | |
| size | button的大小 | large | middle | small | - | |
| value | 根据value进行比较,判断是否选中 | string | number | - |
ts
interface RadioGroupOption {
label: string
value: string | number
disabled?: boolean
}interface RadioGroupOption {
label: string
value: string | number
disabled?: boolean
}Radio.Group Events 事件
| 事件 | 说明 | 类型 |
|---|---|---|
| change | 选项改变事件 | (value: CustomEvent<string | number>) => void |
Radio.Group Slots 插槽
| 事件 | 说明 |
|---|---|
| default | 自定义默认内容 |
| label | 自定义渲染label |