- Accordion
- Attachment
- Avatar
- Badge
- Breadcrumb
- Button
- Button Group
- Card
- Checkbox
- Code Block
- Collapsible
- Dialog
- Dropdown Menu
- Empty
- Field
- Hover Card
- Input
- Input Group
- Input OTP
- Item
- Label
- Marker
- Message
- Number Flow
- Pagination
- Popover
- Progress
- Radio Group
- Select
- Slider
- Sonner
- Spinner
- Switch
- Tooltip
- Separator
- Sheet
- Tabs
- Textarea
- Toggle
- Toggle Group
- Trace
import { cva, type VariantProps } from "class-variance-authority";
import { Separator } from "@/components/ui/separator";
import { Slot } from "@/components/ui/slot";
import { cn } from "@/lib/utils";
const buttonGroupVariants = cva(
"group/button-group flex w-fit items-stretch *:focus-visible:relative *:focus-visible:z-10 has-[>[data-slot=button-group]]:gap-2 has-[select[aria-hidden=true]:last-child]:[&>[data-slot=select-trigger]:last-of-type]:rounded-r-lg [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1",
{
defaultVariants: {
orientation: "horizontal",
},
variants: {
orientation: {
horizontal:
"[&>*:not(:first-child)]:rounded-l-none [&>*:not(:first-child)]:border-l-0 [&>*:not(:last-child)]:rounded-r-none [&>[data-slot]:not(:has(~[data-slot]))]:rounded-r-lg!",
vertical:
"flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:first-child)]:border-t-0 [&>*:not(:last-child)]:rounded-b-none [&>[data-slot]:not(:has(~[data-slot]))]:rounded-b-lg!",
},
},
}
);
function ButtonGroup({
className,
orientation,
...props
}: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>) {
return (
<div
className={cn(buttonGroupVariants({ orientation }), className)}
data-orientation={orientation}
data-slot="button-group"
role="group"
{...props}
/>
);
}
type ButtonGroupTextProps = Omit<React.ComponentProps<"div">, "ref"> & {
as?: React.ElementType;
asChild?: boolean;
ref?: React.Ref<HTMLElement>;
} & Record<string, unknown>;
function ButtonGroupText({
as,
asChild = false,
className,
...props
}: ButtonGroupTextProps) {
const Comp = as ?? (asChild ? Slot : "div");
return (
<Comp
className={cn(
"bg-muted flex items-center gap-2 rounded-lg border px-2.5 text-sm font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
/>
);
}
function ButtonGroupSeparator({
className,
orientation = "vertical",
...props
}: React.ComponentProps<typeof Separator>) {
return (
<Separator
className={cn(
"bg-input relative self-stretch data-horizontal:mx-px data-horizontal:w-auto data-vertical:my-px data-vertical:h-auto",
className
)}
data-slot="button-group-separator"
orientation={orientation}
{...props}
/>
);
}
export {
ButtonGroup,
ButtonGroupSeparator,
ButtonGroupText,
buttonGroupVariants,
};Groups adjacent buttons into a single visual unit. Buttons inside a group share borders and outer corners so they read as one control. Works with Button, Input, Select, DropdownMenu, and anything that renders [data-slot].
Installation
$ bunx --bun frakment add button-group$ npx frakment add button-group$ pnpm dlx frakment add button-group$ yarn dlx frakment add button-group
Install the following dependencies:
$ bun add class-variance-authority$ npm install class-variance-authority$ pnpm add class-variance-authority$ yarn add class-variance-authority
Install registry dependencies.
Button Group imports Slot and Separator. Install both first.
"use client";
import * as React from "react";
export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
children?: React.ReactNode;
ref?: React.Ref<HTMLElement>;
}
function setRef(
ref: React.Ref<HTMLElement> | undefined,
node: HTMLElement | null
) {
if (!ref) {
return;
}
if (typeof ref === "function") {
ref(node);
} else {
(ref as React.MutableRefObject<HTMLElement | null>).current = node;
}
}
function mergeRefs(...refs: Array<React.Ref<HTMLElement> | undefined>) {
return (node: HTMLElement | null) => {
for (const ref of refs) {
setRef(ref, node);
}
};
}
function Slot({ children, ref, ...slotProps }: SlotProps) {
if (!React.isValidElement(children)) {
return null;
}
const childProps = children.props as SlotProps;
const merged: Record<string, unknown> = { ...slotProps, ...childProps };
for (const key of Object.keys(slotProps)) {
const slotValue = (slotProps as Record<string, unknown>)[key];
const childValue = (childProps as Record<string, unknown>)[key];
if (typeof slotValue === "function" && typeof childValue === "function") {
merged[key] = (...args: unknown[]) => {
(childValue as (...a: unknown[]) => unknown)(...args);
(slotValue as (...a: unknown[]) => unknown)(...args);
};
}
}
merged.className =
[slotProps.className, childProps.className].filter(Boolean).join(" ") ||
undefined;
merged.style = { ...slotProps.style, ...childProps.style };
merged.ref = mergeRefs(ref, childProps.ref);
return React.cloneElement(
children as React.ReactElement<Record<string, unknown>>,
merged
);
}
export { Slot };"use client";
import type * as React from "react";
import { cn } from "@/lib/utils";
export interface SeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
decorative?: boolean;
orientation?: "horizontal" | "vertical";
}
function Separator({
className,
orientation = "horizontal",
decorative = true,
...props
}: SeparatorProps) {
return (
<div
aria-orientation={decorative ? undefined : orientation}
className={cn(
"bg-border shrink-0 data-[orientation=horizontal]:h-px data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-px",
className
)}
data-orientation={orientation}
data-slot="separator"
role={decorative ? "none" : "separator"}
{...props}
/>
);
}
export { Separator };Copy and paste the following code into your project.
import { cva, type VariantProps } from "class-variance-authority";
import { Separator } from "@/components/ui/separator";
import { Slot } from "@/components/ui/slot";
import { cn } from "@/lib/utils";
const buttonGroupVariants = cva(
"group/button-group flex w-fit items-stretch *:focus-visible:relative *:focus-visible:z-10 has-[>[data-slot=button-group]]:gap-2 has-[select[aria-hidden=true]:last-child]:[&>[data-slot=select-trigger]:last-of-type]:rounded-r-lg [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1",
{
defaultVariants: {
orientation: "horizontal",
},
variants: {
orientation: {
horizontal:
"[&>*:not(:first-child)]:rounded-l-none [&>*:not(:first-child)]:border-l-0 [&>*:not(:last-child)]:rounded-r-none [&>[data-slot]:not(:has(~[data-slot]))]:rounded-r-lg!",
vertical:
"flex-col [&>*:not(:first-child)]:rounded-t-none [&>*:not(:first-child)]:border-t-0 [&>*:not(:last-child)]:rounded-b-none [&>[data-slot]:not(:has(~[data-slot]))]:rounded-b-lg!",
},
},
}
);
function ButtonGroup({
className,
orientation,
...props
}: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>) {
return (
<div
className={cn(buttonGroupVariants({ orientation }), className)}
data-orientation={orientation}
data-slot="button-group"
role="group"
{...props}
/>
);
}
type ButtonGroupTextProps = Omit<React.ComponentProps<"div">, "ref"> & {
as?: React.ElementType;
asChild?: boolean;
ref?: React.Ref<HTMLElement>;
} & Record<string, unknown>;
function ButtonGroupText({
as,
asChild = false,
className,
...props
}: ButtonGroupTextProps) {
const Comp = as ?? (asChild ? Slot : "div");
return (
<Comp
className={cn(
"bg-muted flex items-center gap-2 rounded-lg border px-2.5 text-sm font-medium [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
/>
);
}
function ButtonGroupSeparator({
className,
orientation = "vertical",
...props
}: React.ComponentProps<typeof Separator>) {
return (
<Separator
className={cn(
"bg-input relative self-stretch data-horizontal:mx-px data-horizontal:w-auto data-vertical:my-px data-vertical:h-auto",
className
)}
data-slot="button-group-separator"
orientation={orientation}
{...props}
/>
);
}
export {
ButtonGroup,
ButtonGroupSeparator,
ButtonGroupText,
buttonGroupVariants,
};Update the import paths to match your project setup.
Usage
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";<ButtonGroup>
<Button variant="outline">Archive</Button>
<Button variant="outline">Report</Button>
<Button variant="outline">Snooze</Button>
</ButtonGroup>Orientation
import { MinusIcon, PlusIcon } from "lucide-react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
export function ButtonGroupOrientation() {
return (
<ButtonGroup
aria-label="Media controls"
className="h-fit"
orientation="vertical"
>
<Button size="icon" variant="outline">
<PlusIcon />
</Button>
<Button size="icon" variant="outline">
<MinusIcon />
</Button>
</ButtonGroup>
);
}Pass orientation="vertical". Borders and radii adjust so the group reads as one column.
Size
import { PlusIcon } from "lucide-react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
export function ButtonGroupSize() {
return (
<div className="flex flex-col items-start gap-8">
<ButtonGroup>
<Button size="sm" variant="outline">
Small
</Button>
<Button size="sm" variant="outline">
Button
</Button>
<Button size="sm" variant="outline">
Group
</Button>
<Button size="icon-sm" variant="outline">
<PlusIcon />
</Button>
</ButtonGroup>
<ButtonGroup>
<Button variant="outline">Default</Button>
<Button variant="outline">Button</Button>
<Button variant="outline">Group</Button>
<Button size="icon" variant="outline">
<PlusIcon />
</Button>
</ButtonGroup>
<ButtonGroup>
<Button size="lg" variant="outline">
Large
</Button>
<Button size="lg" variant="outline">
Button
</Button>
<Button size="lg" variant="outline">
Group
</Button>
<Button size="icon-lg" variant="outline">
<PlusIcon />
</Button>
</ButtonGroup>
</div>
);
}Buttons inside a group keep their own size. The group does not enforce a size, so you can mix and match.
Split
import { PlusIcon } from "lucide-react";
import { Button } from "@/components/ui/button";
import {
ButtonGroup,
ButtonGroupSeparator,
} from "@/components/ui/button-group";
export function ButtonGroupSplit() {
return (
<ButtonGroup>
<Button variant="secondary">Button</Button>
<ButtonGroupSeparator />
<Button size="icon" variant="secondary">
<PlusIcon />
</Button>
</ButtonGroup>
);
}ButtonGroupSeparator adds a thin divider between adjacent buttons. Use it when the visual separation between actions matters more than the tight border merge.
Separator
import { Button } from "@/components/ui/button";
import {
ButtonGroup,
ButtonGroupSeparator,
} from "@/components/ui/button-group";
export function ButtonGroupSeparatorDemo() {
return (
<ButtonGroup>
<Button size="sm" variant="secondary">
Copy
</Button>
<ButtonGroupSeparator />
<Button size="sm" variant="secondary">
Paste
</Button>
</ButtonGroup>
);
}Dropdown
"use client";
import {
CheckIcon,
ChevronDownIcon,
CopyIcon,
ShareIcon,
TrashIcon,
TriangleAlertIcon,
UserRoundXIcon,
VolumeOffIcon,
} from "lucide-react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuGroup,
DropdownMenuItem,
DropdownMenuSeparator,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
export function ButtonGroupDropdown() {
return (
<ButtonGroup>
<Button variant="outline">Follow</Button>
<DropdownMenu>
<DropdownMenuTrigger as={Button} className="pl-2!" variant="outline">
<ChevronDownIcon />
</DropdownMenuTrigger>
<DropdownMenuContent align="end" className="w-44">
<DropdownMenuGroup>
<DropdownMenuItem>
<VolumeOffIcon />
Mute Conversation
</DropdownMenuItem>
<DropdownMenuItem>
<CheckIcon />
Mark as Read
</DropdownMenuItem>
<DropdownMenuItem>
<TriangleAlertIcon />
Report Conversation
</DropdownMenuItem>
<DropdownMenuItem>
<UserRoundXIcon />
Block User
</DropdownMenuItem>
<DropdownMenuItem>
<ShareIcon />
Share Conversation
</DropdownMenuItem>
<DropdownMenuItem>
<CopyIcon />
Copy Conversation
</DropdownMenuItem>
</DropdownMenuGroup>
<DropdownMenuSeparator />
<DropdownMenuGroup>
<DropdownMenuItem variant="destructive">
<TrashIcon />
Delete Conversation
</DropdownMenuItem>
</DropdownMenuGroup>
</DropdownMenuContent>
</DropdownMenu>
</ButtonGroup>
);
}DropdownMenuTrigger with as={Button} inside a ButtonGroup renders as a button that visually joins the group.
Input
import { SearchIcon } from "lucide-react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
import { Input } from "@/components/ui/input";
export function ButtonGroupInput() {
return (
<ButtonGroup>
<Input placeholder="Search..." />
<Button aria-label="Search" variant="outline">
<SearchIcon />
</Button>
</ButtonGroup>
);
}Input Group
"use client";
import { AudioLinesIcon, PlusIcon } from "lucide-react";
import * as React from "react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
import {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupInput,
} from "@/components/ui/input-group";
import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@/components/ui/tooltip";
export function ButtonGroupInputGroup() {
const [voiceEnabled, setVoiceEnabled] = React.useState(false);
return (
<ButtonGroup className="[--radius:9999rem]">
<ButtonGroup>
<Button size="icon" variant="outline">
<PlusIcon />
</Button>
</ButtonGroup>
<ButtonGroup>
<InputGroup>
<InputGroupInput
disabled={voiceEnabled}
placeholder={
voiceEnabled ? "Record and send audio..." : "Send a message..."
}
/>
<InputGroupAddon align="inline-end">
<Tooltip>
<TooltipTrigger
aria-pressed={voiceEnabled}
as={InputGroupButton}
data-active={voiceEnabled}
onClick={() => setVoiceEnabled(!voiceEnabled)}
size="icon-xs"
>
<AudioLinesIcon />
</TooltipTrigger>
<TooltipContent>Voice Mode</TooltipContent>
</Tooltip>
</InputGroupAddon>
</InputGroup>
</ButtonGroup>
</ButtonGroup>
);
}Nested
import { AudioLinesIcon, PlusIcon } from "lucide-react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
import {
InputGroup,
InputGroupAddon,
InputGroupInput,
} from "@/components/ui/input-group";
import {
Tooltip,
TooltipContent,
TooltipTrigger,
} from "@/components/ui/tooltip";
export function ButtonGroupNested() {
return (
<ButtonGroup>
<ButtonGroup>
<Button size="icon" variant="outline">
<PlusIcon />
</Button>
</ButtonGroup>
<ButtonGroup>
<InputGroup>
<InputGroupInput placeholder="Send a message..." />
<Tooltip>
<TooltipTrigger align="inline-end" as={InputGroupAddon}>
<AudioLinesIcon />
</TooltipTrigger>
<TooltipContent>Voice Mode</TooltipContent>
</Tooltip>
</InputGroup>
</ButtonGroup>
</ButtonGroup>
);
}ButtonGroup can be nested. Inner groups opt out of the outer group border merging via the data-slot attribute.
Select
"use client";
import { ArrowRightIcon } from "lucide-react";
import * as React from "react";
import { Button } from "@/components/ui/button";
import { ButtonGroup } from "@/components/ui/button-group";
import { Input } from "@/components/ui/input";
import {
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@/components/ui/select";
const CURRENCIES = [
{ label: "US Dollar", value: "$" },
{ label: "Euro", value: "€" },
{ label: "British Pound", value: "£" },
];
export function ButtonGroupSelect() {
const [currency, setCurrency] = React.useState("$");
return (
<ButtonGroup>
<ButtonGroup>
<Select onValueChange={setCurrency} value={currency}>
<SelectTrigger className="font-mono">
<SelectValue />
</SelectTrigger>
<SelectContent>
{CURRENCIES.map((item) => (
<SelectItem key={item.value} value={item.value}>
{item.value}
<span className="text-muted-foreground">{item.label}</span>
</SelectItem>
))}
</SelectContent>
</Select>
<Input pattern="[0-9]*" placeholder="10.00" />
</ButtonGroup>
<ButtonGroup>
<Button aria-label="Send" size="icon" variant="outline">
<ArrowRightIcon />
</Button>
</ButtonGroup>
</ButtonGroup>
);
}SelectTrigger inside a group widens with w-fit unless you set a width, so the trigger never pushes adjacent buttons off the group.
API Reference
ButtonGroup
| Prop | Type | Default | Description |
|---|---|---|---|
orientation | horizontalvertical | horizontal | Direction of the group. |
className | string | — | Additional CSS classes merged with cn(). |
props | React.ComponentProps<div> | — | Forwarded to the root div. |
ButtonGroupText
| Prop | Type | Default | Description |
|---|---|---|---|
as | React.ElementType | — | Renders a different root element or component. Defaults to div. |
className | string | — | Additional CSS classes. |
ButtonGroupSeparator
Wraps Separator with group-aware styling. Accepts every Separator prop. See Separator for the base API.
Accessibility
ButtonGroupsetsrole="group"anddata-orientationon the root div, so screen readers announce the grouped context.- Children keep their own roles and labels. The group does not override them.
- Icon-only buttons inside the group still need an
aria-labelon the button itself, not on the group.
Best Practices
- Group actions that belong to the same task. Archive and Report belong together. Archive and Delete do not.
- Keep group size uniform. Mixing
smandlginside a group reads as a bug, not a feature. - Use
ButtonGroupSeparatorsparingly. The default border merge is enough for most cases. - Nested groups need an outer ButtonGroup. The outer wrapper adds the gap and keeps the composition readable.
Custom radius
Override --radius on the wrapper to square off or fully round the group. All children inherit the variable.
<ButtonGroup className="[--radius:9999rem]">
<Button variant="outline">Back</Button>
<Button variant="outline">Next</Button>
</ButtonGroup>