ActionMenu

ActionMenu is composed of ActionList and Overlay patterns used for quick actions and selections.

Page navigation navigation

The ActionMenu is an extremely versatile component that is not restricted to a single type of ActionList items at a time. It can be used to create a combination of single select, multi-select, commands, and submenus.

By using dividers and section titles, a hierarchy can be established within the ActionMenu, making it easier to navigate and understand. This allows users to quickly find and access the actions they need, while also providing a clear and organized structure to the menu.

Anatomy

ActionMenu opened with an internal `Settings` label. Several elements are emphasized, such as the trigger, actions, overlay menu, trailing visual shortcuts, trailing visual submenu indicator, and the 3 dot dialog indicator.Edit in Figma

Content

Avoid input controls

The focus should always remain on menu items, and therefore the menu shouldn't include additional form elements like button, input, or checkbox.

Do
Edit in Figma
Use ActionMenu for quick actions.
Don’t
Edit in Figma

Don't add FormControls like a filterable input, use SelectPanel instead.

Icons

When designing menus, it is crucial to adhere to the meaning of the icons used. If any item in the menu does not have a corresponding icon, then all items in that menu should be presented without icons.

Do
Edit in Figma
When one of the items doesn't have an icon then remove icons altogether.
Don’t
Edit in Figma
Don't mix items with or without icons as this makes it harder to read.

Especially when providing single or multi select items that rely on a crossmark icon should be avoided as they could be confused with the item's checkmark.

Do
Edit in Figma
Avoid the usage of icons if the icon conflicts with the selected states checkmark.
Don’t
Edit in Figma
Don't use crossmark icons for single or multi select items.

Trailing visuals

Avoid using trailing visuals to add additional interactions, which reserves them for submenu indicators or keyboard shortcuts.

Do
Edit in Figma
Create a new section for additional functionality.
Don’t
Edit in Figma
Don't store additional toggleable functionality in trailing visuals.

Multi-level

It's important to understand that menus can't include additional form elements like inputs.

Since you can't include form elements within a menu that also means that you can't combine a SelectPanel with a ActionMenu. Alternatively, you can open a Dialog.

Do
Edit in Figma
If you want to present filterable data open a Dialog instead of a submenu.
Don’t
Edit in Figma
Don't use form elements inside a menu.

When using submenus, don't use the trailing visual to communicate selected values within its submenu. Leave this space for submenu indicators.

Do
Edit in Figma
Use trailing visuals for submenu indicators or keyboard shortcuts.
Don’t
Edit in Figma
Don't use trailing visual to communicate selected items in submenus.