# MRadioGroup

A radio button is a selection control that allows users to choose a single option from a list of mutually exclusive choices. Unlike checkboxes, only one option can be selected at a time within the same group. Radio Buttons are commonly used in forms, surveys, and settings where a single choice must be made.<br><br> To put a label, requierement text, help text or to apply a valid or invalid message, the examples are available in the [Field Group section](/docs/form-elements-field-group--docs#radio-group).


## Props

| Name | Description | Type | Default |
| --- | --- | --- | --- | 
| `name*` | The name attribute for the radio element, typically used for form submission. | `string` | - |
| `modelValue` | Property used to manage the values checked by v-model
(Do not use directly) | `string` | - |
| `options*` | list of properties of each radio button of the radio group | `{ id: string; label: string; value: string; disabled?: boolean` `undefined; }[]` | - |
| `isInvalid` | If `true`, applies an invalid state to the radio group. | `boolean` | - |
| `inline` | If `true`, make the form element of the group inline. | `boolean` | - |

## Events

| Name | Description | Type |
| --- | --- | --- |
| `update:modelValue` | Emits when the radio group value changes, updating the modelValue prop. | [value: string] |

## Dependencies

### Depends on

- [MRadio](../radio)

### Graph

```mermaid
graph TD;
  MRadioGroup --> MRadio
style MRadioGroup fill:#008240,stroke:#333,stroke-width:4px
```