Radio Group

Radio groups are control elements that allow the user to make a single selection from a list of options.

Preview

Variants

Default

With Options

Passing in Radio components programmatically using an options object.

Without Legend

When no legend is provided it is expected that an aria-label is passed into the component.

With Slotted Legend

The legend can also be passed by slot.

With Event Hander

The event handler is only needed if you need to do additional processing. The v-model is automatically updated.

With Validation States

Vue API

import { DtRadioGroup } from '@dialpad/dialtone-vue';

Slots

Name
Type
default

slot for Input Group Components

legend

slot for Input Group Legend

Props

Name
Default
Type
name required
string

The name of the input group

dataQaGroup
'radio-group'
string

A data qa tag for the radio group

dataQaGroupLegend
'radio-group-legend'
string

A data qa tag for the radio group legend

dataQaGroupMessages
'radio-group-messages'
string

A data qa tag for the radio group messages

disabled
false
"true" | "false"

Disables the input group

id
generated unique ID
string

The id of the input group

legend
''
string

The legend of the input group

legendChildProps
{}
object

A set of props that are passed into the legend element

legendClass
''
string|array|object

Used to customize the legend element

messages
[]
array

Validation messages

messagesChildProps
{}
object

A set of props that are passed into the messages container

messagesClass
''
string|array|object

Used to customize the messages container

modelValue
''
string|number

A provided value for the radio group

showMessages
true
"true" | "false"

Show validation messages

value
null
string|number|boolean|object

The value of the input group

Events

Name
Type
update:modelValue
String | Number

Event fired to sync the modelValue prop with the parent component

Accessibility

Radio Groups are typically paired with a legend which identifies the group. If no legend is provided then it is expected that an aria-label will be given in order to provide an invisible label to screen readers.

Radio Group documentation last updated Thursday, June 18, 2026