Skip to Content
ComponentsToggle Group

Toggle Group

A set of two-state buttons that can be toggled on or off.

import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"
<ToggleGroup type="single"> <ToggleGroupItem value="left" aria-label="Align left"> <TextAlignLeft className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"> <TextAlignCenter className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"> <TextAlignRight className="size-4" /> </ToggleGroupItem> </ToggleGroup>

Examples

Multiple selection

<ToggleGroup type="multiple"> <ToggleGroupItem value="left" aria-label="Align left"> <TextAlignLeft className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"> <TextAlignCenter className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"> <TextAlignRight className="size-4" /> </ToggleGroupItem> </ToggleGroup>

Outline variant

<ToggleGroup type="single" variant="outline"> ... </ToggleGroup>

Sizes

<ToggleGroup type="single" size="default"> <ToggleGroupItem value="left" aria-label="Align left"><TextAlignLeft className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"><TextAlignCenter className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"><TextAlignRight className="size-4" /></ToggleGroupItem> </ToggleGroup> <ToggleGroup type="single" size="compact"> <ToggleGroupItem value="left" aria-label="Align left"><TextAlignLeft className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"><TextAlignCenter className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"><TextAlignRight className="size-4" /></ToggleGroupItem> </ToggleGroup>
Last updated on