Skip to content

ToggleGroup ​

Overview ​

A group of toggle buttons that share variant and size context.

Theme entry: ToggleGroup

Props ​

NameTypeRequiredDefaultDescription
themeOverrideObjectnullA partial ThemeObject keyed by component name, merged over this component's theme and provided to descendants.
classimport('vue').HTMLAttributes['class']undefinedAdditional CSS classes to apply to the root element.
variantstringundefinedVisual style variant.
sizestringundefinedSize variant.
spacingnumber0The gap spacing between items (0 = flush/no-gap).
typestringundefinedThe selection type: 'single' or 'multiple'.
modelValuestring|arrayundefinedThe controlled value.
defaultValuestring|arrayundefinedThe default value.
disabledbooleanundefinedWhether the group is disabled.
dirstringundefinedThe reading direction.
loopbooleanundefinedWhether to loop keyboard navigation.
orientationstringundefinedThe orientation.
rovingFocusbooleanundefinedWhether to allow deselection of a single value.
asstring|objectundefinedThe element or component to render as.
asChildbooleanfalseWhen true, merges props onto the child element instead of rendering a wrapper.

Slots ​

default ​

Scoped slot.

Events ​

NameDescription
update:modelValueEmitted when the value changes.

Full event reference

Source ​

client/lib/controls/toggle-group/ToggleGroup.vue