Pluma
Overview
About
MCP server
CLI
Codemods
3.0.0
Button Variant Rename
2.170.0
Banner Description Prop
Getting started
Contributing
Breaking changes
Changelog
Foundations
Content
Icons
Motion
Principles
Style utilities
Test helpers
Tokens
All Tokens
Color
Spacing
Typography
Elevation
Motion
AI
Components
Status
Layout
Accordion
AccordionGroup
AspectRatio
Box
Card
CenterBaseline
Divider
EmptyState
Flex
FormLayout
Grid
InlineStack
Panel
Scrollable
SplitView
Stack
Typography
Code
DescriptionList
Emphasis
Heading
List
Paragraph
Strong
Text
TextLabel
Truncated
Content
Avatar
CodeBlock
Coin
Icon
Image
LabelIcon
Navigation
Breadcrumbs
Link
NavItem
Page
Pagination
PlainLink
SideNav
Tabs
TabNav
Buttons
Button
ButtonGroup
CloseButton
DropdownMenu
PlainButton
ToggleButton
Forms
Checkbox
CheckboxGroup
ColorPicker
Combobox
DatePicker
FileField
Form
JsonField
NumberField
OptionCard
OptionCardGroup
Radio
RadioGroup
Search
SegmentedControl
Select
Slider
TextArea
TextField
Toggle
Data display
Badge
DataTable
Filters
FormattedDateTime
FormattedRelativeTime
KeyboardShortcut
Label
ProgressBar
ProgressCircle
StatusIndicator
Table
Tag
Timeline
Feedback
Banner
PageLoader
SkeletonShape
SkeletonText
Snackbar
Spinner
Overlays
Blanket
ConfirmationModal
Drawer
Drawer manager
Modal
Modal manager
Popover
Tooltip
Misc
VisuallyHidden
Patterns
Density
States
Advanced
Ember Floating UI
Ember prop spreading
ESLint plugin
tooltip-custom-interactive
no-banned-imports
enforce-pluma-elements
no-deprecated-apis
no-deprecated-icons
no-raw-pluma-classnames
no-raw-pluma-css-variables
require-form-control-label
prefer-managed-modals
ModalPrimitive
PlumaProvider
PopoverPrimitive
Portal
React yield
Fly Migration
fly-alert
fly-badge
fly-btn
fly-card
fly-close
fly-label
fly-panel
fly-progress
fly-range
fly-spinner
fly-tag
Forms
Lists
Tailwind
Componentsv2.189.0
Iconsv1.19.0
MCPv0.8.61
Tokensv0.34.3

ButtonGroup

Figma
Github
Storybook
Aria pattern

The ButtonGroup component renders a group of related buttons next to each other.

Importing

You can import the component via:

import { ButtonGroup } from '@customerio/pluma-components/react';

Usage

To use the component, wrap a group of Button components with the ButtonGroup:

Props

ButtonGroup accepts a subset of Button props, which will then be passed down to the Button components (via context):

  • variant
  • size
  • isDisabled

Spaced groups

ButtonGroup accepts a groupVariant prop, which can be set to spaced to render a group of buttons separated by a gap. This is to ensure consistent gaps between buttons throughout the UIs.

API

PlumaButtonGroup extends Box

groupVariant  "segmented" | "spaced" | undefined

Default:segmented

Whether the buttons should be rendered as a connected group (segmented) or equally spaced apart (spaced).

isDisabled  boolean | undefined

Disables all buttons in the group.

size  "sm" | "small" | "medium" | "md" | undefined

Default:md

The size of the buttons. medium and small are deprecated, use md and sm instead.

unsafe_iconColor  "critical" | "caution" | "success" | "accent" | "base" | "information" | "invert" | "subtle" | "feature" | undefined

Change the color of the icon. By default, the icon inherits the button's text color. Use with care, as it can cause inconsistencies in the UI.

unsafe_iconSize  "sm" | "xl" | "xs" | "xxs" | "md" | "lg" | "fill" | undefined

Overrides the icon size used within the button. Should only be used deliberately, as it can cause inconsistencies in the UI. For example, this is used in Pagination to increase the icon size.

variant  "subtle" | "primary" | "secondary" | "tertiary" | undefined

Default:secondary

The variants of buttons to render.

On this page

Importing
Usage
Props
Spaced groups
API