Skip to Content
ComponentsRadioGroup

RadioGroup

A group of radio buttons for selecting a single option. Built on Ark UI .

Framework

Import

import { RadioGroup } from '@grannyshot/ui'

Usage

<RadioGroup.Root defaultValue="option1"> <RadioGroup.Item value="option1" label="Option 1" /> <RadioGroup.Item value="option2" label="Option 2" /> </RadioGroup.Root>

With Label

<RadioGroup.Root defaultValue="react" label="Framework"> <RadioGroup.Item value="react" label="React" /> <RadioGroup.Item value="vue" label="Vue" /> <RadioGroup.Item value="svelte" label="Svelte" /> </RadioGroup.Root>

Horizontal

<RadioGroup.Root defaultValue="sm" orientation="horizontal"> <RadioGroup.Item value="sm" label="Small" /> <RadioGroup.Item value="md" label="Medium" /> <RadioGroup.Item value="lg" label="Large" /> </RadioGroup.Root>

Sizes

<RadioGroup.Root size="sm" defaultValue="a"> <RadioGroup.Item value="a" label="Small" /> </RadioGroup.Root> <RadioGroup.Root size="md" defaultValue="a"> <RadioGroup.Item value="a" label="Medium" /> </RadioGroup.Root> <RadioGroup.Root size="lg" defaultValue="a"> <RadioGroup.Item value="a" label="Large" /> </RadioGroup.Root>

Disabled

<RadioGroup.Root defaultValue="a" disabled> <RadioGroup.Item value="a" label="Disabled A" /> <RadioGroup.Item value="b" label="Disabled B" /> </RadioGroup.Root>

API Reference

RadioGroup.Root

PropTypeDefaultDescription
size'sm' | 'md' | 'lg''md'Radio button size
labelstringGroup label
orientation'horizontal' | 'vertical''vertical'Layout direction
defaultValuestringDefault selected value
valuestringControlled selected value
onValueChange(details: { value: string }) => voidChange handler
disabledbooleanfalseDisable all items
classNamestringAdditional CSS classes

RadioGroup.Item

PropTypeDefaultDescription
valuestringItem value (required)
labelstringItem label text
disabledbooleanfalseDisable this item
classNamestringAdditional CSS classes
Last updated on