Light themes
Dark themes

Make your own

Button Group

A button group is a tray that holds related buttons 4px apart, so they read as one control.

2

Playground

Related buttons in one tray: actions on an order, icon actions split by a rule, a quantity stepper, or a main action with more choices.

HTML

Use

  • Several actions on the same object: reply, forward, archive.
  • A quantity stepper: minus, the value, plus.
  • A main action with a second button that opens more choices.

For a choice between options (one stays selected) use Toggle Group instead.

Markup

<div class="tray-btn-group" role="group" aria-label="…"> holds <button class="tray-btn-group__item">. Add tray-btn-group__item--icon for an icon-only button (give it an aria-label), tray-btn-group--sm for 44px items, tray-btn-group--vertical to stack, and <span class="tray-btn-group__rule"> for a hairline between two clusters.

The stepper is the same tray with data-tray="stepper", two buttons carrying data-step="-1" and data-step="1", and an <output class="tray-btn-group__value">. Set data-min and data-max; it fires tray:change with detail.value.

Accessibility

The group needs role="group" and an aria-label that names what its buttons act on. Tab reaches each button in turn. The stepper's <output> is a live status by default, so its new value is announced when it changes; its buttons need aria-labels ("One fewer", "One more"). At data-min and data-max the button that would pass the limit becomes disabled; if it had focus, focus moves to the group first, so it is not dropped to the top of the page, and Tab goes on from there. Under prefers-reduced-motion: reduce the number changes without its bump.

Do and don't

  • Do keep the tray: buttons are never fused edge to edge, nothing in the system has a hard corner.
  • Don't mix sizes inside one group.
  • Don't put the primary yellow button in a group; set it beside the group.
↑↓ to moveEnter to openEsc to close