# radio-group (w-radio-group)

- **Import**: `WRadioGroup` from `win-design-next`
- **Tag**: `<w-radio-group>`
- **说明**: WRadioGroup
- **分类**: data-entry
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/radio.md`

## API

## RadioGroup API

### Attributes

| 属性名                      | 说明                                                                    | 类型                                                             | 默认值                                                   |
| --------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------- |
| model-value / v-model       | 绑定值                                                                  | ^[string] / ^[number] / ^[boolean]                               | —                                                        |
| size                        | 单选框按钮或边框按钮的大小                                              | ^[string]                                                        | default                                                  |
| disabled                    | 是否禁用                                                                | ^[boolean]                                                       | false                                                    |
| text-color                  | 按钮形式的 Radio 激活时的文本颜色                                       | ^[string]                                                        | #ffffff                                                  |
| fill                        | 按钮形式的 Radio 激活时的填充色和边框色                                 | ^[string]                                                        | #2d5afa                                                  |
| validate-event              | 输入时是否触发表单的校验                                                | ^[boolean]                                                       | true                                                     |
| aria-label ^(a11y)          | 与 RadioGroup 中的 `aria-label` 属性相同                                | ^[string]                                                        | —                                                        |
| name                        | 原生 `name` 属性                                                        | ^[string]                                                        | —                                                        |
| id                          | 原生 `id` 属性                                                          | ^[string]                                                        | —                                                        |
| label ^(a11y) ^(deprecated) | 与 RadioGroup 中的 `aria-label` 属性相同                                | ^[string]                                                        | —                                                        |
| options ^(1.1.14)           | 选项的数据源， value 的 key 和 label 和 disabled 可以通过 props 自定义. | ^[array]`Array`                                                  | —                                                        |
| props ^(1.1.14)             | 配置选项， 可以自定义 value, label, disabled 的 key.                    | ^[object]`{ value?: string, label?: string, disabled?: boolean}` | `{value: 'value', label: 'label', disabled: 'disabled'}` |
| type ^(1.1.14)              | 渲染选项的组件类型 (例如 `'button'`)                                    | ^[enum]`'radio' \| 'button'`                                     | 'radio'                                                  |
| allow-deselect ^(1.1.14)    | 是否允许取消选择                                                        | ^[boolean]                                                       | false                                                    |

### Events

| 事件名 | 说明                   | 类型                                                      |
| ------ | ---------------------- | --------------------------------------------------------- |
| change | 绑定值变化时触发的事件 | ^[Function]`(value: string \| number \| boolean) => void` |

### Slots

| 插槽名  | 说明           | 子标签              |
| ------- | -------------- | ------------------- |
| default | 自定义默认内容 | Radio / RadioButton |
