Skip to content

Radio 单选框

单选框。

何时使用

  • 用于在多个备选项中选中单个状态。
  • Select的区别是,Radio所有选项默认可见,方便用户在比较中选择,因此选项不宜过多。

基本使用

最简单的用法。

不可用

Radio不可用。

单选组合

一组互斥的Radio配合使用。

Radio.Group 垂直

垂直的Radio.Group,配合更多输入框选项。

Radio.Group 组合 - 配置方式

通过配置options参数来渲染单选框。也可通过optionType参数来设置Radio类型。

按钮样式

按钮样式的单选组合。

大小

大中小三种组合,可以和表单输入框进行对应配合。

填底的按钮样式

实色填底的单选按钮样式。

Group Option自定义label

如果使用Radio.Groupoptions选项想自定义label内容,则可以使用label插槽实现。

Radio Props 属性

属性说明类型默认值版本
buttonStylebutton的风格样式,目前有描边和填色两种风格outline | solidoutline
checked指定当前是否选中booleanfalse
defaultChecked初始是否选中booleanfalse
disabled禁用booleanfalse
nameinput[type="radio"]name属性string-
sizebutton的大小large | middle | small-
typeradio的类型default | buttondefault
value根据value进行比较,判断是否选中string | number-

Radio Slots 插槽

事件说明
default自定义默认内容

Radio.Group Props 属性

属性说明类型默认值版本
buttonStylebutton的风格样式,目前有描边和填色两种风格outline | solidoutline
defaultChecked初始是否选中booleanfalse
disabled禁用booleanfalse
nameinput[type="radio"]name属性string-
options以配置形式设置子元素RadioGroupOption[]-
optionType用于设置Radio options类型default | buttondefault
sizebutton的大小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