Radio Group
Radio Group menampilkan dua sampai lima pilihan sekaligus dan membiarkan orang memilih tepat satu.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk 2 sampai 5 pilihan yang perlu dibandingkan sebelum memilih, misalnya jenis rilis.
- Pakai Select untuk pilihan yang lebih banyak, dan Switch atau Checkbox untuk satu pengaturan ya atau tidak.
- Selalu pilihkan nilai bawaan yang masuk akal.
Anatomi
Section titled “Anatomi”- 1Pilihan
- 2Pilihan terpilih
- 3Label
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
Section titled “Varian”Hanya ada satu gaya.
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/radio-group.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/radio-group.jsonAksesibilitas
Section titled “Aksesibilitas”- Grup punya
role="radiogroup"yang dinamai legendanya; setiap pilihan punyarole="radio". - Tab masuk ke grup pada pilihan yang terpilih; tombol panah memindahkan pilihan.
- Hubungkan setiap deskripsi ke pilihannya lewat
aria-describedby.
