# Radio

Native radio buttons and radio groups, restyled.

Source: https://www.zazz.sh/api/primitives/radio/

## Installation

```bash
pnpm dlx zazz-ui add radio
```

Also adds `fields`, which it depends on.

Run `zazz-ui init` first if the project has no `zazz/` folder yet.

## Examples

### Default

```html
<fieldset data-ui="radio-group">
  <legend>Options</legend>
  <div
    style="
      --display: flex-col;
      --gap: 2;
    "
  >
    <label data-ui="field" data-field-orientation="horizontal">
      <input data-ui="radio" type="radio" name="radio-options-example" value="option-1" />
      <span data-field-slot="label">Option 1</span>
    </label>
    <label data-ui="field" data-field-orientation="horizontal">
      <input data-ui="radio" type="radio" name="radio-options-example" value="option-2" checked />
      <span data-field-slot="label">Option 2</span>
    </label>
    <label data-ui="field" data-field-orientation="horizontal">
      <input data-ui="radio" type="radio" name="radio-options-example" value="option-3" />
      <span data-field-slot="label">Option 3</span>
    </label>
  </div>
</fieldset>
```

## Attributes

| Attribute | Kind | Values |
| --- | --- | --- |
| `data-ui="radio-group"` | identity | free value |
| `data-ui="radio"` | identity | free value |

Requires: fields.

## Hooks

| Hook | Default | State |
| --- | --- | --- |
| `--ui-radio-bg` | `var(--ui-field-bg)` | — |
| `--ui-radio-bg--checked` | `var(--color-primary)` | checked |
| `--ui-radio-border-color` | `var(--ui-field-border-color)` | — |
| `--ui-radio-border-color--checked` | `var(--ui-field-border-color--hover)` | checked |
| `--ui-radio-border-color--hover` | `var(--ui-field-border-color--hover)` | hover |
| `--ui-radio-border-style` | `var(--ui-field-border-style)` | — |
| `--ui-radio-border-width` | `var(--ui-field-border-width)` | — |
| `--ui-radio-corner-shape` | `round` | — |
| `--ui-radio-dot-color` | `var(--color-primary-foreground)` | — |
| `--ui-radio-dot-mask` | `radial-gradient( circle calc(var(--ui-radio-dot-size) / 4), #000 calc(100% - 0.5px), #0000 calc(100% + 0.5px) )` | — |
| `--ui-radio-dot-size` | `calc(var(--ui-radio-size) * 0.85)` | — |
| `--ui-radio-radius` | `var(--radius-full)` | — |
| `--ui-radio-size` | `calc(var(--spacing) * 4.5)` | — |
