Description
A toolbar is a grouped set of controls used to apply actions to related content.
 |
Usage & Behavior
The toolbar may be used in conjunction 3 components.
Type | Image |
|---|---|
 | |
 | |
Chart |  |
General guidelines
Structure
The toolbar is shown as a horizontal single row.
Placement and Positioning
The toolbar is located on top of a data container (e.g. Data Table).
It should use the maximum width of the container.
Where possible the toolbar should be divided into 2 distinct types of operations:
Action options, left-aligned - options that impact the data (e.g. delete).
View options, right-aligned - options impacting the view of the data (e.g. print, search, change view mode etc.)
Where all options are view options, they will be left-aligned.
Content
A toolbar can include:
a variety of components, such as Action Menus, Buttons, and Search.
information such as counters and statuses. (See example in the Data Table image above).
Dialog Buttons cannot be used within a toolbar.
Optionally, a hamburger Icon Button can be used to group multiple actions into an Action Menu.
If actions can be grouped, they should be separated by a vertical divider (for example, table-level actions | row-level actions).
Internal Logic
A toolbar can be used for single or multiple selection actions on the related content.
Controls in the toolbar can be enabled/disabled in response to data selection (e.g. Delete can be disabled if no data is selected).
States
The toolbar itself has no states. Each component on the toolbar will behave according to its own states.
Validations and errors
The toolbar itself has no validations or errors. Each component on the toolbar may have its own validations.
Best practices
Use:
If management of the data set relies on several controls, and the actions are applicable to the related content.
Don’t use:
If a ribbon pattern is used.
General:
Where possible, consider using only Icon Buttons, with a corresponding Tooltip.
Icon buttons with text should be used to emphasize one or two specific actions.
Accessibility Compliance
Unless otherwise specified, see our general compliance information in Fundamentals - Accessibility.
Design
Zeplin link | Screen thumbnail |
|---|---|
 |
Code
