ui/docs/content/3.components/radio-group.md

title, description, category, links

title	description	category	links
RadioGroup	A set of radio buttons to select a single option from a list.	form	label icon to RadioGroup i-custom-reka-ui https://reka-ui.com/docs/components/radio-group label icon to GitHub i-simple-icons-github https://github.com/nuxt/ui/tree/v3/src/runtime/components/RadioGroup.vue

Usage

Use the v-model directive to control the value of the RadioGroup or the default-value prop to set the initial value when you do not need to control its state.

Items

Use the items prop as an array of strings, numbers or booleans:

::component-code

prettier: true ignore:

• modelValue
• items external:
• items
• modelValue externalTypes:
• RadioGroupItem[]
• RadioGroupValue props: modelValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

You can also pass an array of objects with the following properties:

• label?: string{lang="ts-type"}
• description?: string{lang="ts-type"}
• value?: string{lang="ts-type"}
• disabled?: boolean{lang="ts-type"}

::component-code

ignore:

• modelValue
• items external:
• items
• modelValue externalTypes:
• RadioGroupItem[]
• RadioGroupValue props: modelValue: 'system' items:
  • label: 'System' description: 'This is the first option.' value: 'system'
  • label: 'Light' description: 'This is the second option.' value: 'light'
  • label: 'Dark' description: 'This is the third option.' value: 'dark'

---

::

::caution When using objects, you need to reference the value property of the object in the v-model directive or the default-value prop. ::

Value Key

You can change the property that is used to set the value by using the value-key prop. Defaults to value.

::component-code

ignore:

• modelValue
• items
• valueKey external:
• items
• modelValue externalTypes:
• RadioGroupItem[]
• RadioGroupValue props: modelValue: 'light' valueKey: 'id' items:
  • label: 'System' description: 'This is the first option.' id: 'system'
  • label: 'Light' description: 'This is the second option.' id: 'light'
  • label: 'Dark' description: 'This is the third option.' id: 'dark'

---

::

Legend

Use the legend prop to set the legend of the RadioGroup.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items externalTypes:
• RadioGroupItem[] props: legend: 'Theme' defaultValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

Color

Use the color prop to change the color of the RadioGroup.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items externalTypes:
• RadioGroupItem[] props: color: neutral defaultValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

Variant :badge

Use the variant prop to change the variant of the RadioGroup.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items props: color: 'primary' variant: 'table' defaultValue: 'pro' items:
  • label: 'Pro' value: 'pro' description: 'Tailored for indie hackers, freelancers and solo founders.'
  • label: 'Startup' value: 'startup' description: 'Best suited for small teams, startups and agencies.'
  • label: 'Enterprise' value: 'enterprise' description: 'Ideal for larger teams and organizations.'

---

::

Size

Use the size prop to change the size of the RadioGroup.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items externalTypes:
• RadioGroupItem[] props: size: 'xl' variant: 'list' defaultValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

Orientation

Use the orientation prop to change the orientation of the RadioGroup. Defaults to vertical.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items externalTypes:
• RadioGroupItem[] props: orientation: 'horizontal' variant: 'list' defaultValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

Indicator :badge

Use the indicator prop to change the position or hide the indicator. Defaults to start.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items externalTypes:
• RadioGroupItem[] props: indicator: 'end' variant: 'card' defaultValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

Disabled

Use the disabled prop to disable the RadioGroup.

::component-code

prettier: true ignore:

• defaultValue
• items external:
• items externalTypes:
• RadioGroupItem[] props: disabled: true defaultValue: 'System' items:
  • 'System'
  • 'Light'
  • 'Dark'

---

::

API

Props

:component-props

Slots

:component-slots

Emits

:component-emits

Theme

:component-theme