Skip to content

Radio 单选框

原生 <input type="radio"> 增强,支持单选组与受控 value。

基础用法

基础用法

选项一选项二

同名 name 的 radio 互斥(组件跨 Shadow DOM 同步);无 name 时各自独立,互斥请用同名或 oas-radio-group

单选组

单选组(radio-group)

选择支付方式微信支付支付宝银行卡

组通过 value 受控,子项 value 作为选项标识;组会统一管理单选互斥。

单个禁用

单个 disabled

可选已禁用禁用且选中

单项 disabled 只禁该项:不可点击、不可聚焦(原生 disabled 语义),组内其余项不受影响;整组禁用走 oas-radio-groupdisabled(见下)。

禁用

禁用

已选且禁用禁用禁用

事件

切换事件

选项 A选项 B选项 C

监听 oas-change:单项派发 detail: { checked, value },组派发 detail: { value }

API

属性

属性说明类型默认值
checked是否选中boolean
disabled禁用boolean
name原生分组名(组内自动管理)string
value选项标识string

事件

事件说明
oas-change变化,detail: { checked, value };组为 detail: { value }

插槽

名称说明
默认

oas-radio-groupvalue(选中值)、disabled,支持 slot="label" 设置组标题。