Updated: November 16, 2023

Toolbar

FUIToolbar

Intro

The toolbar is a component with one or more buttons that is always located at the bottom edge of the screen. It is used for closing or finalizing actions that impact the current view. When scrolling, the toolbar remains fixed and does not scroll away.

Toolbar in compact width (left) and regular width (right)
Toolbar in compact width (left) and regular width (right)

Usage

Do
  • Use the toolbar if you need closing or finalizing actions.
  • Use descriptive and concise verbs as button labels.
  • Only use a primary button if your app has a clear primary action.
  • Use text-only buttons or buttons with icons and text.
  • Use an overflow menu if your toolbar on iPhone requires more than two text buttons.
  • Use an overflow menu if your toolbar on iPad requires more than three text buttons.
Information
Western readers usually scan a view in a Z-pattern – from left to right and top to bottom. As a result, the best position for a finalizing action is the bottom right side of a view.
Don't
  • Don’t use the toolbar if its action influences only specific items instead of the entire view.
  • Don’t combine icon-only and text-only buttons within a toolbar.
  • Don’t mix tertiary buttons with secondary or primary buttons within a toolbar.
  • Don’t use the helper text if your toolbar has an overflow button.

Anatomy

A. Toolbar Container

The toolbar container contains one or more buttons. The toolbar is always visible, even when users scroll down.

B. Secondary Text Button

Actions that are not the primary action should be formatted as secondary buttons. If the view has no clear primary action or if the displayed actions have the same relevance, the toolbar can consist of only secondary buttons. Use the secondary style only if there are two or more buttons within the toolbar.

C. Primary Text Button

Emphasize the most important action with the primary button style. Show only one primary action for the entire view. If the toolbar has only one button, we recommend formatting the button in primary style.

D. Overflow Button

If the toolbar has more than two text buttons in compact view, the additional text buttons move into an overflow menu. The most important actions are displayed first. In regular view, the overflow appears after three text buttons.

E. Tertiary Text Button

Tertiary text buttons can be used if the toolbar consists of additional actions that the user may need to access. Tertiary text buttons can be used if the toolbar should be subtle, yet perceivable.

F. Helper Text

The helper text can be used for displaying information or status. It is read-only and not tappable.

G. Tertiary Icon Button

Tertiary icon buttons can be used if the toolbar consists of additional actions that the user may need to access. Tertiary icon buttons can be used if the toolbar should be subtle, yet perceivable. Keep in mind to use icon buttons that can be represented by universally recognized icons.

Toolbar anatomy with variants
Toolbar anatomy with variants
Information
We recommend using filled buttons, such as primary or secondary buttons, for the most likely actions in a view. Filled buttons have a container with a solid fill. The filled style is visually more prominent than tertiary buttons which helps people quickly identify the action they want to perform.

Semantic Actions

We recommend formatting semantic buttons in secondary button style. For negative or destructive actions, the negative red button can be used. For positive actions, use the secondary style in tint color. The positive action should be placed on the right side.

Semantic actions within a toolbar
Semantic actions within a toolbar

Behavior and Interaction

Overflow Menu

Text Buttons

A maximum of two text buttons can be displayed in the toolbar in compact view. If the toolbar has more than two text buttons, the additional text buttons move into an overflow menu. The most important actions are displayed first. In regular view, the overflow appears if there are more than three text buttons.

Overflow Interaction

Tapping on the overflow button opens an action sheet with additional action buttons.

Tapping on the overflow button (left) opens an action sheet with additional actions (right)
Tapping on the overflow button (left) opens an action sheet with additional actions (right)

Long Button Labels

The overflow should always be activated when there is not enough space to display all the buttons. If there is not enough space to display two buttons because the button text is too long, the secondary button moves into the overflow and the more important action is stretched across the full width of the toolbar.

An overflow button should also be used when both buttons do not fit into the toolbar’s width
An overflow button should also be used when both buttons do not fit into the toolbar’s width
Information
Truncated labels in buttons do not meet our accessibility standards since it is not possible to retrieve the full label text. You should implement an overflow behavior to ensure that all actions can be accessed at any time. The buttons are sorted by usage, with the most frequently used action first (on the right). This ensures that the most important buttons are the last to be moved into the overflow menu.

Adaptive Design

The toolbar spacing follows the global layout margins of the iOS and iPadOS size classes. It uses 100% of the screen width.

In compact view, the buttons are equally distributed across the container of the toolbar. In regular view, the buttons are aligned to the right side of the container to provide convenient access to the buttons.

Information
If a keyboard is on screen then the toolbar appears right above the keyboard.
Toolbar in compact (left) and regular width (right)
Toolbar in compact (left) and regular width (right)

Variations

The toolbar can be flexibly adapted depending on the context, amount and importance of the actions. App designers must decide here which toolbar variant makes the most sense for their app. If the current view has a clear primary action, then a toolbar with primary action might be a good choice. If there is no clear primary action, then a toolbar with only secondary or only tertiary buttons should be considered.

Toolbar variations
Toolbar variations

Resources

Development: FUIToolbar

SAP Fiori for Android: Persistent Footer

SAP Fiori for Web: Footer Toolbar

Human Interface Guidelines: Toolbars