We will be updating this content to our new principle-based format in the near future.
A collection of buttons commonly used to select an option
A Button group is a useful component for grouping together buttons to allow a user to select an option.
The Button Group acts as a wrapper for multiple buttons. It removes the spacing and border radius between adjacent buttons, making them sit flush next to each other. It is used to indicate a relationship between similar actions - pagination and toolbars are great examples of this.
The Button Group by itself doesn't have any visual elements. The Group simply removes the spacing between buttons and makes them sit flush beside each other.
Container - wraps the component and removes border-radius and spacing between buttons.
Buttons - the Button Components added to the Group.
3Sizing & Spacing
The Button Group should always use the same size Button components. This allows the buttons to be positioned flush against each other. The Buttons themselves though can be any of the available sizes outlined on the Button Docs page.
4Hierarchy & Placement
The Button Group is used to collate similar actions together under one consistent grouping. It should only feature Secondary Buttons, as Primary Buttons should be standalone actions.