This guideline now covers both SAPUI5 and SAP Web Components. Learn more.
Information
Icon
false

Intro

The menu button is a UI component that opens a menu containing a list of related actions for the user to select from. In split mode, the menu button also supports a default action that can be triggered directly without opening the menu.

Two menu buttons with dropdown arrows: a regular menu button on the left and a split menu button on the right.

Regular menu button and split menu button

Component availability

The menu button component is available in the following libraries:

<div> <div data-valign="middle">Library</div> <div data-valign="middle">Technical Name</div> <div data-valign="middle">Identifier</div> </div> <div> <div data-valign="middle">SAPUI5 Demo Kit</div> <div><a href="https%3A%2F%2Fui5.sap.com%2F%23%2Fentity%2Fsap.m.MenuButton">sap.m.MenuButton</a></div> <div data-valign="middle">:badge, info, large, _, SAPUI5:</div> </div> <div> <div data-valign="middle">SAP Web Components</div> <div data-valign="middle"><a href="https%3A%2F%2Fui5.github.io%2Fwebcomponents%2Fcomponents%2Fmain%2FButton%2F">ui5-button</a><div><a href="https%3A%2F%2Fui5.github.io%2Fwebcomponents%2Fcomponents%2FSplitButton%2F">ui5-split-button</a></div></div> <div data-valign="middle">:badge, info, large, _, SAP Web Components:</div> </div> <div> <div data-valign="middle">SAP Web UI Kit (Figma)</div> <div data-valign="middle"><a href="https://www.figma.com/design/SILcWzK5uFghKun9jx6D7c/SAP-Web-UI-Kit?node-id=405763-7671&t=R50w9sciHSscOmxz-4">Menu Button</a><div><a href="https://www.figma.com/design/SILcWzK5uFghKun9jx6D7c/SAP-Web-UI-Kit?node-id=405763-7711&t=R50w9sciHSscOmxz-4">Split Button</a></div></div> <div data-valign="middle">:badge, info, large, _, Figma:</div> </div></div>
<div> <div data-valign="middle">Library</div> <div data-valign="middle">Technical Name</div> <div data-valign="middle">Identifier</div> </div> <div> <div data-valign="middle">SAPUI5 Demo Kit</div> <div><a href="https%3A%2F%2Fui5.sap.com%2F%23%2Fentity%2Fsap.m.MenuButton">sap.m.MenuButton</a></div> <div data-valign="middle">:badge, info, large, _, SAPUI5:</div> </div> <div> <div data-valign="middle">SAP Web Components</div> <div data-valign="middle"><a href="https%3A%2F%2Fui5.github.io%2Fwebcomponents%2Fcomponents%2Fmain%2FButton%2F">ui5-button</a><div><a href="https%3A%2F%2Fui5.github.io%2Fwebcomponents%2Fcomponents%2FSplitButton%2F">ui5-split-button</a></div></div> <div data-valign="middle">:badge, info, large, _, SAP Web Components:</div> </div> <div> <div data-valign="middle">SAP Fiori for Web UI Kit (Figma)</div><div data-valign="middle"><a href="https%3A%2F%2Fwww.figma.com%2Fcommunity%2Ffile%2F1494295794601744471">Menu Button</a><div><a href="https%3A%2F%2Fwww.figma.com%2Fcommunity%2Ffile%2F1494295794601744471">Split Button</a></div></div> <div data-valign="middle">:badge, info, large, _, Figma:</div> </div> </div>

The guideline covers the menu button component. For other button types, see the Buttons Overview.

When to Use

2
do
false

Use the regular menu button to:

  • Group related actions when there is no clear default action.

Use the split menu button to:

  • Group related actions when one action is used more often than the others.
dont
false

Don’t use the menu or split menu button to:

  • Switch between different states. Use the toggle button or the switch instead.
  • Perform individual actions that are not intended to be grouped. Use the simple button instead.
toptip
  • Use regular and split menu buttons to group actions in a single menu, including items and submenus.
  • Use the regular menu button to group related, equivalent actions under a single trigger.
  • Use the split menu button when one action is used more often than the others.
  • In split mode, describe the default action in the button text. If the default action appears as an icon only, use icons for all menu items.
  • Apply button text and icon buttons guidelines to menu buttons to ensure actions are clear.
  • Use the emphasized menu button for primary actions.
  • Use the standard menu button for secondary actions.
  • Use the transparent menu button for tertiary actions.
  • Always pair icon-only menu buttons with a tooltip that labels the action.

Anatomy

The menu button component consists of the following elements:

  1. Background: Indicates the button state using different colors.
  2. Text: Describes actions triggered by the menu button or the default action of the split button type.
  3. Arrow: Indicates that the button opens a menu with multiple items.
  4. Separator: Indicates that the two areas in the split menu button trigger different actions.

Regular and split menu button anatomy with numbered labels pointing to the background (1), text (2), dropdown arrow (3), and separator (3) in the split menu button.

Regular and split menu button anatomy

Types

There are two types of menu buttons. Both open a menu with items. These items trigger actions or open further submenus.

Two open menu buttons labeled A and B: A shows a regular menu with four items, and B shows a split menu button with a submenu opened from the first menu item.

Menu button with opened menu (A) and split menu button with opened menu and submenu (B)

Regular

The regular menu button groups related actions under a single trigger.

Regular menu button labeled Paste followed by another one with a dropdown menu showing the options Paste, Paste Special, Paste as Plain Text, and Paste as Hyperlink.

Regular type

Split

The split menu button is separated into two interactive areas by a divider – the text area, which triggers the default action, and the arrow icon, which opens the menu. The split menu button combines multiple actions and highlights a primary action.

In split mode, the text describes the default action. If the default action is displayed as an icon only, all the menu items must contain icons.

Two split menu buttons labeled Paste: the left button is closed, and the right button shows an open dropdown menu with the options Paste, Paste Special, Paste as Plain Text, and Paste as Hyperlink.

Split type

Display types

The menu button supports three display types.

A: Text only
B: Icon only
C: Text and icon

Three display types for menu and split buttons: A) Text only ("Menu Button", "Split Button"), B) Icon only (with dropdown arrows), and C) Text and icon combined.

Display types

Hierarchy types

Emphasized

The emphasized menu button appears with a blue background and white text and icons. Use it for primary actions.

Six primary menu buttons arranged in two columns, showing regular and split menu button variants with text labels, icon-only buttons, and combined icon-and-text buttons.

Emphasized type

Standard

The standard menu button appears with a white background and subtle gray border. Use it for secondary actions.

Six secondary menu buttons with white backgrounds arranged in two columns, showing regular and split menu button variants with text labels, icon-only buttons, and combined icon-and-text buttons.

Standard type

Transparent

The transparent menu button appears with a transparent background and no border. Use it for tertiary actions.

Six tertiary menu buttons with transparent backgrounds arranged in two columns, showing regular and split menu button variants with text labels, icon-only buttons, and combined icon-and-text buttons.

Transparent type

States

Component states

The menu button has two component states: enabled and disabled.

A: Enabled: Displays an interactive state and supports selection.
B: Disabled: Displays a non-interactive state.

Two rows of regular and split menu buttons in enabled (interactive) and disabled (non-interactive) states.

Enabled (A) and disabled (B) states

For more information, see Component States.

Interaction states

The menu button has three interaction states: regular, hover, and down.

A. Regular: Displays the default interaction state.
B. Hover: Displays the hover state when the cursor is over an enabled menu button.
C. Down: Displays the pressed state during interaction.

Three columns of regular and split menu buttons displaying regular, hover, and down states.

Regular (A), hover (B), and down (C) states

For more information, see Interaction States.

Focus states

The focus state indicates which component is currently focused and provides visual feedback for users who rely on assistive technology or don’t use a mouse.

Focus state appears as an additional visible border that the menu button receives.

When interacting using a keyboard, the focus state appears on the entire split menu button. When interacting using a mouse, it appears only on the specific area the user clicks.

Four menu buttons displaying focus outlines around different areas, including the full button, text area, and dropdown arrow area.

Focus states

For more information, see Focus States.

Value states

Menu buttons support value states to indicate status using distinct colors.

A. Negative: Indicates an error or issue that requires resolution.
B. Critical: Signals a warning or something that needs caution or a follow-up action.
C. Positive: Shows success or confirmation that an action has been completed.

Regular and split menu buttons in negative (red), critical (yellow), and positive (green) states.

Negative (A), critical (B), and positive (C) states

For more information, see Value States.

Behavior and Interaction

Mouse interaction

Regular menu button

The regular menu button has a single interactive area. Selecting it opens a menu that contains multiple available actions.

A: When clicking on the menu button without releasing the click, the down and focus states are applied.
B: After releasing the click, the menu opens, and the focus state is applied on the first item.

Pressed regular menu button (A) and a regular menu button (B) with open menu showing four options Add New Pin, Shared Images, Share Location, and Export Map.

Regular menu button interaction

Split menu button

The split menu button consists of two interactive areas: the default action and the arrow icon. Selecting the default action triggers the default action directly, while selecting the arrow icon opens a dropdown menu with additional actions. A separator between the two interactive areas indicates that they trigger different behaviors. When a menu item is chosen, its action is triggered and the menu closes.

A: When clicking on the right interactive area without releasing the click, the down and focus states are applied. The left interactive area stays in regular state.
B: After releasing the click, the menu opens, and focus state applies on the first option.

Pressed Split Menu Button (A) and a Split Menu button (B) with open menu showing four options Add New Pin, Shared Images, Share Location, and Export Map.

Split menu button interaction

Touch interaction

On touch devices, the behavior is similar to the mouse interaction, without the hover and focus states.

For more information, see Gestures.

Tooltip

Always provide a tooltip when the menu button appears as icon-only.

Icon-only menu button and split button with tooltips displayed on hover, labeled Actions and Default Action.

Icon-only menu and split buttons with tooltip

Display an “Open Menu” tooltip on the arrow icon in split menu buttons.

Split Menu button with Open Menu tooltip displayed below a cursor that is hovering over the dropdown arrow.

A split button with a tooltip displayed on the arrow icon

For more information, see Using Tooltips.

By default, the menu is horizontally left-aligned to the menu button. Alternatively, it can also be center-aligned or right-aligned.

By default, when sufficient space is available, the menu appears below the menu button.

Three split menu buttons with open menus aligned left, center, and right below the buttons.

Menu position: below the menu button

If space is limited, the menu opens above the menu button to ensure full visibility and to avoid overlapping or extending beyond the viewport.

Three split menu buttons with open menus aligned above the buttons to the left, center, and right.

Menu position: above the menu button

Default action :badge, info, large, _, SAPUI5 Only:

In a split menu button, the left interactive area’s default action can be either static or dynamic.

Static

After triggering the default action or an action from the menu, the default action of the left interactive area stays unchanged.

Split menu button labeled Create with an open menu showing two actions, followed by the same button after selection with the default action unchanged.

Static default action

Dynamic

After triggering an action from the menu, the triggered action becomes the new default action of the left interactive area.

Split menu button labeled Create with an open menu showing two actions, followed by the same button after selection with the chosen action becoming the new default action.

Dynamic default action

Responsiveness

By default, the menu button fits the width of the text.

Two groups of menu and split menu buttons in short, medium, and long widths that adjust to the content length.

Menu and split buttons with different lengths

If the menu button has a fixed width, its text can truncate if it’s too long to fit.

Two groups of menu and split menu buttons with fixed widths showing truncated text in the bottom row for longer labels.

Menu and split buttons with a fixed width and different text length

The menu button supports cozy and compact content densities.

Regular and split menu buttons shown in cozy (top row) and compact (bottom row) layouts.

Cozy content density (top) and compact content density (bottom)

For more information, see Content Density.

Accessibility

SAP follows international standards, such as WCAG and WAI-ARIA, and strives to make our business solutions accessible and inclusive.

For more information, see Accessibility in SAP Fiori and the Accessibility Design Tools Handbook.

Keyboard navigation

The following keyboard combinations are supported by the SAPUI5 menu button component.

<div> <div>Key combination</div> <div>What it does</div> </div> <div> <div><strong>Tab</strong></div> <div>Moves the focus to the button. If the focus is already there, the focus is moved to the next UI element.</div> </div> <div> <div><strong>Shift + Tab</strong></div> <div>Backward navigation.</div> </div> <div> <div><strong>Enter/ Return</strong> or <strong>Spacebar</strong></div> <div>In regular mode, opens the menu and sets the focus to the first item.<br>In split button mode, if the entire menu button or the left interactive area is focused, triggers the default action. If the right interactive area is focused, opens the menu and sets the focus to the first item.</div> </div> <div> <div><strong>Shift</strong> or <strong>Esc</strong></div> <div>On pressed Space/Enter, additionally pressing Shift/Esc releases the menu button without triggering the associated action.</div> </div> <div> <div><strong>Alt + Up Arrow</strong> or<br><strong>Alt + Down Arrow</strong> or <strong>F4</strong></div> <div>If the menu is closed, opens the menu and sets focus to the first item.<br>If the menu is opened, closes the menu and sets focus back to the button.</div> </div> <div> <div><strong>Up Arrow</strong><br><strong>Down Arrow</strong></div> <div>If the menu is closed, the menu opens and the focus is set to the first item.<br>If the menu is open, the key navigates through the items.</div> </div>

Screen reader support

For additional details on screen reader support and Accessible Rich Internet Applications (ARIA), see UI5 Screen Reader Support and WAI-ARIA Authoring.

Content

Text

Truncation

For more information, see Wrapping and Truncation.

Localization

The menu button supports left-to-right (LTR) and right-to-left (RTL) reading directions. All features work in both directions.

Regular and split menu buttons in a left-to-right layout, shown as text-only, icon-only, and combined icon-and-text variants with dropdown arrows aligned to the right.

Menu button – left-to-right

Regular and split menu buttons in a right-to-left layout, shown as text-only, icon-only, and combined icon-and-text variants with dropdown arrows aligned to the left.

Menu button – right-to-left

Framework Comparison

Some behaviors differ between frameworks due to implementation specifics. In SAP Web Components, the menu button is not a standalone component but a pattern built from a regular button (ui5-button) with a down-arrow icon, which indicates that it opens a menu (ui5-menu). The split button is available as a dedicated component (ui5-split-button) in SAP Web Components, while in SAPUI5, the split button behavior is provided as a type of the dedicated menu button component.

The table below summarizes the differences between SAPUI5 and SAP Web Components.

<div> <div>Feature</div> <div>SAPUI5</div> <div>SAP Web Components</div> </div> <div> <div>In a split menu button, the left interactive area’s default action can be either static or dynamic. For more information, see the <a href="https://www.sap.com/design-system/fiori-design-web/ui-elements/menu-button#default-action">Default action</a> section.</div> <div>Available</div> <div>Not available</div> </div> </div>

Guidelines

Components
Button
Toggle Button
Segmented Button
Menu

Implementation

SAPUI5
Menu Button (samples)
Menu Button (API reference)

SAP Web Components
Menu Button
Split Button

Specifications

Menu Button (visual design)

SAP Web UI Kit

Menu Button (Figma)

Guidelines

Components
Button
Toggle Button
Segmented Button
Menu

Implementation

SAPUI5
Menu Button (samples)
Menu Button (API reference)

SAP Web Components
Menu Button
Split Button

UI Kit (Figma)

SAP Fiori for Web UI Kit / Menu Button