跳到正文
贡献者

RadioGroup

使用 fieldset/legend 语义管理一组选项,并统一处理标签、校验和禁用状态。

基础用法

默认游戏模式
当前:survival

API

Props

名称类型默认说明
modelValuestring | number | boolean''当前选中的值,支持通过 v-model 双向绑定。
options{ label, value, disabled? }[][]生成单选项的数据;也可使用默认插槽手工声明 McRadio
directionhorizontal | verticalhorizontal单选项横向或纵向排列。
labelstring-单选组标题,并作为 fieldsetlegend
descriptionstring-显示在单选项前的补充说明。
hintstring-无错误时显示的辅助提示。
disabledbooleanfalse是否禁用组内全部单选项。
readonlybooleanfalse是否只读展示并阻止选项切换。
requiredbooleanfalse是否要求选择一项,并接入 McForm 验证。
rulesMcRule<McRadioValue>[][]字段验证规则列表,规则可同步或异步返回结果。
errorMessagesstring | string[]-外部错误消息;提供后直接显示为错误状态。
validateOninput | blur | submit | lazyinput覆盖字段的验证触发时机;位于 McForm 中时可继承表单设置。
idstring自动生成单选组与辅助文本关联所用的 id。
namestring自动生成传递给组内原生 radio 的 name,使其参与同一组选中行为。

默认插槽可替换 options,手工声明 Radio 子项。事件:update:modelValuechange。组本身作为单一 Form 字段注册,组内 Radio 不会再各自注册。

最后更新于

MIT Licensed · Ore UI 风格 Vue 3 组件库