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.