# Action menu

<figure><img src="https://1297765105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMoZPkWOmnKvoMWGW4aeM%2Fuploads%2Fttn4R6mUSH40ki9rNq0k%2FActionMenu%20Hero.png?alt=media&#x26;token=5b8dc620-90e5-4e4f-b366-15ca00f28665" alt="2 versions of an action menu"><figcaption></figcaption></figure>

## Overview

Action menus are displayed to the user after a click on a button ([Split Button](https://design.mirakl.com/~/changes/DpgERwSwrKIthStzL4D6/components/buttons#split-button), [Menu Button](https://design.mirakl.com/~/changes/DpgERwSwrKIthStzL4D6/components/buttons#menu-button), [Icon Button](https://design.mirakl.com/~/changes/DpgERwSwrKIthStzL4D6/components/buttons#icon-button)).

## Guidelines <a href="#id-5758e9" id="id-5758e9"></a>

* Must be used for secondary (or sub-)actions that do not require to be visible right away
* Contain actions related to the same object or related to each other.
* Clicking on an item automatically triggers the associated action. Must lead to visual feedback showing the effect and the result of the action to the user or redirect him to the appropriate section of the Mirakl platform.
* Large lists should be avoided. Items in the action list can have nested submenus.
* Items with sub-menus do not contain any related actions other than opening the sub-menu
* A sub-menu list holds the name of its parent item.
* If all actions are disabled, consider disabling the parent component

## Accessibility <a href="#id-69483d" id="id-69483d"></a>

* The first item is automatically given focus when the action menu is triggered with the keyboard
* Navigate through the list using the arrow keys
* Give focus to the list's parent element by pressing the `Esc` or `Shift+Tab` key while on the first item of the list.
* Activate the action using the `enter/return` key or the `space` key

## Key takeaways <a href="#id-8864e6" id="id-8864e6"></a>

{% hint style="success" %}

* Group actions within the menu
  {% endhint %}

{% hint style="danger" %}

* Mix items with icons and items without icons
* Use 2 separators in a row
* Use a separator for the last item on the list
  {% endhint %}
