Toggle Group

Group of Toggles where at most one (single) or many (multiple) can be pressed at a time. Often used as a visual filter or text-alignment picker.

Default

Single-select toggle group.

Allow multiple items pressed at once.

Set variant to outline for bordered items.

sm, default, and lg groups.

Add a gap class to separate the items instead of joining them.

Set orientation to vertical to stack the items.

The disabled attribute blocks the whole group.

A single-select group of text labels bound to a ref.

Prop	Type	Default	Description
`type`	`"single" \| "multiple"`	`"single"`	Selection mode.
`modelValue`	`string \| string[]`	—	Pressed value(s). Supports v-model.
`variant`	`"default" \| "outline"`	`"default"`	Same as Toggle.
`size`	`"sm" \| "default" \| "lg"`	`"default"`	Same as Toggle.

Event	Description
`update:modelValue`	Fires when the pressed value(s) change. Enables v-model.

Prop	Type	Default	Description
`value`	`string`	—	Unique value identifying this item.
`disabled`	`boolean`	`false`	Disable this item.

Keyboard shortcuts and ARIA behavior.