NV NVIDIA Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles CDN Custom Elements Eleventy Golang HTMX + Go Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About What’s New Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions DESIGN.md Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Codeblock Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Bytes Format Datetime Format Number Format Relative Time Forms Validation Actions Control Gauge Icon Icon Button Input Input Group Logo Markdown Markdown CSS Media Controller Media Pause Button Media Playback Rate Select Media Mute Button Media Seek Button Media Time Range Media Volume Range Media Full-screen Button Menu Month Monaco Input Monaco Diff Input Monaco Editor Monaco Diff Editor Monaco Problems Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Button Group

stable:  2.3.0 Coverage: 91.66% Bundle: 12.11kb Lighthouse: 100 Axe Core Released: 0.16.0
Overview API Examples

A button group organizes related buttons and can support either mutually exclusive single or multi selection. Prefer usage within toolbars.

Installation

CLI / MCP / CDN

Split

The Interaction type provides a way to show the intent of an interactive element. This can help users quickly understand what each interaction does and reduce the potential for confusion or errors.

Interaction Description emphasis Shows the interaction targets emphasis or highlighting primary actions. destructive Shows the interaction targets destructive actions such as deleting or removing.

Split button groups with different interaction styles for primary actions with dropdown alternatives.

button button button

Split Rounded

Split button groups with rounded container styling for softer visual appearance and modern aesthetics.

button button button

Container

Set the style of the button group using the container property. Options are the default display when omitting the attribute, flat or rounded.

Container Description flat rounded

Standard

Basic button group for organizing related actions into a unified control with connected visual appearance.

Flat

Set the style of the button group using the container property. Options are the default display when omitting the attribute, flat or rounded.

Container Description flat rounded

Button group with flat container styling for minimal visual appearance and reduced emphasis.

Rounded

Set the style of the button group using the container property. Options are the default display when omitting the attribute, flat or rounded.

Container Description flat rounded

Rounded button group with single selection for segmented controls and filter options with pill-style buttons.

All Time 30 Days 90 Days

Rounded Icon

Rounded button group with icon buttons for compact view switchers and mode toggles.

Selection

By default the button group is stateless. Add the behavior-select attribute and set to single or multi to enable stateful selction handling.

BehaviorSelect Description single multi

Single Select

Button group with single selection behavior for mutually exclusive options like view modes or formatting.

Multi Select

Button group with multi-selection behavior for toggling many options simultaneously like text formatting.

Disabled

Button group in disabled state for indicating unavailable actions or read-only contexts.

button

Orientation

Controls the directional flow of the element's layout and interaction pattern.

Orientation Description horizontal Element orients horizontally with left-to-right flow. vertical Element orients vertically with top-to-bottom flow.

Button group with vertical orientation for sidebars, toolbars, or vertical navigation contexts.

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days