# Radio Group

> Memilih satu dari beberapa pilihan yang semuanya terlihat.

Radio Group menampilkan dua sampai lima pilihan sekaligus dan membiarkan orang memilih tepat satu.

## Kapan dipakai

- Pakai untuk 2 sampai 5 pilihan yang perlu dibandingkan sebelum memilih, misalnya jenis rilis.
- Pakai [Select](https://design.sosialoka.tech/id/components/select/) untuk pilihan yang lebih banyak, dan [Switch](https://design.sosialoka.tech/id/components/switch/) atau [Checkbox](https://design.sosialoka.tech/id/components/checkbox/) untuk satu pengaturan ya atau tidak.
- Selalu pilihkan nilai bawaan yang masuk akal.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/radio-group/_

## Anatomi

1. Pilihan
2. Pilihan terpilih
3. Label

`FieldSet` dengan `FieldLegend` yang berisi pertanyaannya, dan satu baris per pilihan: item bulat berborder `input` yang terisi `primary` saat dipilih, labelnya, dan deskripsi satu kalimat bila perlu.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` / `defaultValue` | `v-model` / `default-value` | `initialValue` | teks | tidak ada | Pilihan terpilih. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat pilihan berubah. |
| `RadioGroupItem value` | `RadioGroupItem value` | `ShadRadio value` | teks | tidak ada | Satu pilihan. |
| label di `FieldLabel` | label di `FieldLabel` | `label`, `sublabel` | teks | tidak ada | Nama pilihan. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Menonaktifkan grup atau satu item. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Field, FieldContent, FieldDescription, FieldLabel, FieldLegend, FieldSet } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const types = [
  { value: "single", label: "Single", hint: "Satu sampai tiga lagu." },
  { value: "ep", label: "EP", hint: "Empat sampai enam lagu." },
  { value: "album", label: "Album", hint: "Tujuh lagu atau lebih." },
]

export default function RadioGroupDemo() {
  const id = useId()
  return (
    <FieldSet className="w-full max-w-sm">
      <FieldLegend id={`${id}-legend`}>Jenis rilis</FieldLegend>
      <RadioGroup defaultValue="single" aria-labelledby={`${id}-legend`}>
        {types.map((t) => (
          <Field key={t.value} orientation="horizontal">
            <RadioGroupItem value={t.value} id={`${id}-${t.value}`} aria-describedby={`${id}-${t.value}-hint`} />
            <FieldContent>
              <FieldLabel htmlFor={`${id}-${t.value}`}>{t.label}</FieldLabel>
              <FieldDescription id={`${id}-${t.value}-hint`}>{t.hint}</FieldDescription>
            </FieldContent>
          </Field>
        ))}
      </RadioGroup>
    </FieldSet>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Field, FieldContent, FieldDescription, FieldLabel, FieldLegend, FieldSet } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const types = [
  { value: "single", label: "Single", hint: "Satu sampai tiga lagu." },
  { value: "ep", label: "EP", hint: "Empat sampai enam lagu." },
  { value: "album", label: "Album", hint: "Tujuh lagu atau lebih." },
]
const id = useId()
</script>

<template>
  <FieldSet class="w-full max-w-sm">
    <FieldLegend :id="`${id}-legend`">Jenis rilis</FieldLegend>
    <RadioGroup default-value="single" :aria-labelledby="`${id}-legend`">
      <Field v-for="t in types" :key="t.value" orientation="horizontal">
        <RadioGroupItem :id="`${id}-${t.value}`" :value="t.value" :aria-describedby="`${id}-${t.value}-hint`" />
        <FieldContent>
          <FieldLabel :for="`${id}-${t.value}`">{{ t.label }}</FieldLabel>
          <FieldDescription :id="`${id}-${t.value}-hint`">{{ t.hint }}</FieldDescription>
        </FieldContent>
      </Field>
    </RadioGroup>
  </FieldSet>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const releaseTypes = {
  'single': ('Single', 'Satu sampai tiga lagu.'),
  'ep': ('EP', 'Empat sampai enam lagu.'),
  'album': ('Album', 'Tujuh lagu atau lebih.'),
};

class RadioGroupDemo extends StatelessWidget {
  const RadioGroupDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return Semantics(
      label: 'Jenis rilis',
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.start,
        spacing: 12,
        children: [
          Text('Jenis rilis', style: ShadTheme.of(context).textTheme.small),
          ShadRadioGroup<String>(
            initialValue: 'single',
            items: [
              for (final MapEntry(key: value, value: (label, hint)) in releaseTypes.entries)
                ShadRadio(value: value, label: Text(label), sublabel: Text(hint)),
            ],
          ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/radio-group.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/radio-group.json
```

## Aksesibilitas

- Grup punya `role="radiogroup"` yang dinamai legendanya; setiap pilihan punya `role="radio"`.
- Tab masuk ke grup pada pilihan yang terpilih; tombol panah memindahkan pilihan.
- Hubungkan setiap deskripsi ke pilihannya lewat `aria-describedby`.
