Skip to content

Radio 单选框

单选框组件,用于在一组选项中选择一个。

注意:Radio 选中后不能取消选中,只能通过选择另一个 Radio 来改变。如需可取消的选项,请使用 Checkbox。

基础用法

默认选中

v-for 循环

尺寸

禁用状态

错误状态

error 属性仅控制单选框边框颜色,不渲染错误消息。

API

Props

属性类型默认值说明
modelValuestring | numberundefined当前选中的值(v-model)
labelstring''标签文字
valuestring | numberundefined单选框的值
size'sm' | 'md' | 'lg''md'尺寸
disabledbooleanfalse是否禁用
errorbooleanfalse是否显示错误状态

Slots

名称说明
default标签内容(优先级高于 label

Events

事件参数说明
update:modelValue(value: string | number)值变化时触发
change(event: Event)原生 change 事件

注意事项

  • Radio 选中后不能取消选中,只能通过选择另一个 Radio 来改变
  • 同一组的 Radio 建议设置相同的 name 属性,以确保键盘导航正确
  • error 属性仅控制边框颜色,不渲染错误消息
  • 聚焦时显示聚焦环,确保可访问性
  • 使用 visibility 控制圆点显隐,避免布局偏移

Released under the MIT License