# gds-radio

**Class**: `GdsRadio`

**Tag**: `<gds-radio>`


## Properties

| Name | Type | Default | Description |
|------|------|---------|-------------|
| `label` | `string` | `-` | The label displayed next to the radio button. |
| `supportingText` | `string` | `-` | The supporting text displayed below the label. This text provides additional context or information to the user. |
| `value` | `string \| boolean` | `-` | The value of the radio button. |
| `checked` | `boolean` | `-` | Whether the radio button is checked or not. |
| `disabled` | `boolean` | `-` | Whether the radio button is disabled or not. |
| `invalid` | `boolean` | `-` | Whether the radio button is invalid or not. |
| `errorMessage` | `string \| undefined` | `-` | The accessible error message text for the radio button.  This text is not visually rendered, but will be announced by screen readers when the radio button is in an invalid state. |
| `syncFirstRender` | `boolean` | `-` | Force the element to perform a synchronous first render and apply style expression properties in `connectedCallback`.  This guarantees that the child DOM always remains projected in DOM, since the element will attach the shadowRoot and run the first render pass in the same event loop cycle, and that declarative layout will be applied once slotted DOM is projected.  Note: This will cause the first render pass to be blocking. Use sparingly and only when necessary, such as when the element needs to be measured synchronously after being added to the DOM. |


## Events

| Name | Type | Description |
|------|------|-------------|
| `input` | `InputEvent` | Dispatched when the radio button is checked. |