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"> <AlignLeft className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"> <AlignCenter className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"> <AlignRight className="size-4" /> </ToggleGroupItem> </ToggleGroup>

Examples

Multiple selection

<ToggleGroup type="multiple"> <ToggleGroupItem value="left" aria-label="Align left"> <AlignLeft className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"> <AlignCenter className="size-4" /> </ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"> <AlignRight 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"><AlignLeft className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"><AlignCenter className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"><AlignRight className="size-4" /></ToggleGroupItem> </ToggleGroup> <ToggleGroup type="single" size="compact"> <ToggleGroupItem value="left" aria-label="Align left"><AlignLeft className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="center" aria-label="Align center"><AlignCenter className="size-4" /></ToggleGroupItem> <ToggleGroupItem value="right" aria-label="Align right"><AlignRight className="size-4" /></ToggleGroupItem> </ToggleGroup>
Last updated on