Skip to content
Direction:
On this page

Radio

A binary input that always exists in a group, in which only one input can be on at a time.

Typical use will involve using v-for to loop through an array of items and output a Radio component for each one. Each Radio will have the same v-model binding and name prop, but different inputValue props and label content.

The v-model value is the inputValue of the Radio that is currently on.

Demos

Radio group

Radio group value: radio-2

Inline radios

Usage

Props

Prop nameDescriptionTypeDefault
modelValueValue of the currently selected radio.

Provided by v-model binding in the parent component.
string|number|boolean''
inputValueHTML "value" attribute to assign to the input.

Required for input groups.
string|number|booleanfalse
nameHTML "name" attribute to assign to the input.

Required for input groups
string''
disabledWhether the disabled attribute should be added to the input.booleanfalse
inlineWhether the component should display inline.

By default, display: block is set and a margin exists between sibling components, for a stacked layout.
booleanfalse

Events

Event namePropertiesDescription
update:modelValuemodelValue string | number | boolean - The new model valueEmitted when modelValue changes.

Slots

NameDescriptionBindings
defaultInput label content