Sections

• Introduction
• Installation
• Styling
• Colors
• Forms
• Skills
• RTL
• LLMs.txt
• Changelog

Components

• Accordion
• Action Bar
• Alert Dialog
• Alert
• Announcement
• Aspect Ratio
• Autocomplete
• Avatar
• Badge
• Bottom Navigation
• Breadcrumb
• Button Group
• Button
• Calendar
• Card
• Carousel
• Chart
• Checkbox
• Circular Progress
• Circular Slider
• Clipboard
• Collapsible
• Color Picker
• Combobox
• Command
• Context Menu
• Data List
• Date InputNew
• Date Picker
• Dialog
• DrawerUpdated
• Editable
• Field
• File Upload
• FloatUpdated
• Floating Panel
• Frame
• Hint
• Hover Card
• Image Cropper
• Input Group
• Input OTP
• Input
• Item
• Kbd
• Link Overlay
• Listbox
• Marquee
• Menu
• Native Select
• Number Input
• Pagination
• Password Input
• Popover
• Progress
• Prose
• QR Code
• Radio Group
• Rating
• Resizable
• Scroll Area
• Segment Group
• Select
• Separator
• Sheet
• Sidebar
• Signature Pad
• Skeleton
• Skip Nav
• Slider
• Spinner
• StatusUpdated
• Steps
• Switch
• Table
• Tabs
• Tags Input
• Textarea
• Timer
• Toast
• Toggle Group
• Toggle Tooltip
• Toggle
• Tooltip
• Tour
• Tree View

Utilities

• Client Only
• Download Trigger
• Format
• Highlight
• Hitbox
• JSON Tree View
• Presence
• Show
• Swap

Forms

• Formisch
• React Hook Form
• TanStack Form

Hooks

• useIsMobile

Button Group

Copy Markdown

Group button elements together.

PreviewCode

ArchiveReportSnooze

Installation#

CLIManual

pnpmbunnpmyarn

pnpm dlx shadcn@latest add @shark/button-group

Anatomy#

ButtonGroup
└── Button or Input
├── ButtonGroupText
└── ButtonGroupSeparator

Usage#

import { 
  ButtonGroup,
  ButtonGroupSeparator,
} from "@/components/ui/button-group";

<ButtonGroup> 
  <Button>
    Archive 
  </Button>
  <ButtonGroupSeparator />
  <Button>
    Report
  </Button>
</ButtonGroup>

Accessibility#

• Use aria-label or aria-labelledby to label the group.

<ButtonGroup aria-label="Media controls">
  <Button>Play</Button>
  <Button>Pause</Button>
</ButtonGroup>

Orientation#

Horizontal#

PreviewCode

Vertical#

PreviewCode

Examples#

Nested#

PreviewCode

Separator#

Buttons with variant outline do not need a separator since they have a border.

PreviewCode

With Input#

PreviewCode

With Menu#

PreviewCode

Subscribe

With Popover#

A popover trigger button can be added to a button group for contextual information or actions.

PreviewCode

Fork42

API Reference#

ButtonGroup#

Groups buttons together. Uses fieldset for accessibility when applicable.

ButtonGroupSeparator#

Visual divider between buttons. Uses Separator internally.

[

Previous page

Breadcrumb ](/docs/components/breadcrumb)[

Next page

Button ](/docs/components/button)

On This Page

InstallationAnatomyUsageAccessibilityOrientationHorizontalVerticalExamplesNestedSeparatorWith InputWith MenuWith PopoverAPI ReferenceButtonGroupButtonGroupSeparator