Toggle Group

Toggles that merge into one capsule of glass.

Installation#

pnpmnpmyarnbun

$ pnpm dlx shadcn@latest add @liquikit/toggle-group

Needs the @liquikit registry in your components.json. Set it up once.

import { ToggleGroup } from "@/components/liquikit/toggle-group"

<ToggleGroup
  options={["Left", "Center", "Right"]}
  defaultValue={["Left"]}
  aria-label="Alignment"
/>

Pass multiple to let more than one toggle stay pressed.

Prop	Type	Default
`theme`	`"light" \| "dark"` Light or dark glass. Falls back to the nearest `GlassThemeProvider`, then light.	—
`lens`	`Partial<LensProfile>` Overrides for the lens profile, such as `thickness`, `bevel`, `ior` and `magnification`.	—
`liquid`	`number` How far the glass squashes and stretches as it moves. `0` keeps it rigid.	—
`options*`	`ReadonlyArray<string \| Segment>` The toggles, as strings or `{ value, label, disabled }` objects.	—
`value`	`string[]` The pressed toggles, when you control them.	—
`defaultValue`	`string[]` The toggles pressed to begin with.	[]
`onValueChange`	`(value: string[], eventDetails?: BaseToggleGroup.ChangeEventDetails) => void` Called with the new value when the user changes it.	—
`height`	`number` Height of the group, in pixels.	—

Also takes every prop of Base UI's toggle group, plus className and style.