# Radio Group

RadioGroup will allow users to choose a single selection from one of a list of
provided options.

## Design & usage guidelines

### Rendering RadioOption with children

If the `RadioGroup` is being used to select something other then text, you can
render the `RadioOptions` with `children`.

## Accessibility

**Note:** When using `children` without a `label` it is the responsibility of
the child to supply the proper accessible labels. If you are using children that
do not contain text, an `aria-label` should be provided.


## Props

### Web

| Prop | Type | Required | Default | Description |
|------|------|----------|---------|-------------|
| `ariaLabel` | `string` | Yes | — | Defines the aria label that describes the radio group. |
| `onChange` | `(newValue: string | number) => void` | Yes | — | Change handler for the RadioGroup. @param newValue |
| `value` | `number | string` | Yes | — | Defines the default value that will be pre-selected in the radio group. |
| `direction` | `"horizontal" | "vertical"` | No | `vertical` | Layout direction for the options. |
| `name` | `string` | No | `useId()` | The name of the radio group, that links the radio options back up to the group. |