Skip to main content

Menu

The Menu component displays the list of action items that are revealed when the user clicks on the trigger element.

When to use

  • To group related actions or navigation items in an overlay. These actions trigger immediate events, such as copying, editing, or deleting a table item, via an options button.

When not to use

  • To choose one or more options from a predefined list of related items that don't trigger immediate events. For example, selecting a timezone in a form. Use Select instead.
  • For disclosure patterns, such as revealing a panel of links or text. Use Accordion or ExpandableText instead.

Side-by-side comparison: an options menu triggering the actions "Copy", "Download", "Edit", and "Delete", versus a Select choosing one option from a "Distribution" list.

Side-by-side comparison: an options menu triggering the actions "Copy", "Download", "Edit", and "Delete", versus a Select choosing one option from a "Distribution" list.

Content guidelines

  1. Trigger button (required)
  2. Options (required)

Anatomy of a Menu with two numbered callouts mapping to the parts described above: Trigger button and Options.

Anatomy of a Menu with two numbered callouts mapping to the parts described above: Trigger button and Options.

Trigger button

The trigger button may include short, clear labels, and prefix and suffix icons. One or more of these elements may be used. The options can also be opened from a dot menu or the app help menu. See the Accessibility tab for guidance on labeling trigger buttons properly for screen readers.

Options

Labels

For actions, start with a verb. For consistency and easy reading, use the same grammatical pattern for all items in a group.

  • Use sentence case (capitalize only the first word and any proper nouns, such as brand names).
  • Keep it short, just one to three words.
  • Remove unnecessary words such as "the", "a", or "an".
  • Don't add trademarks or registered symbols.
  • Don't add periods or ellipses. If the action opens a new view or navigates elsewhere, use an IntentButton. If it opens a nested or multi-level menu, use a chevron.
  • Only use a Tooltip for additional context.

Example of correct Menu options using the short labels "Rename", "Duplicate", and "Delete", and incorrect ones using wordier phrases such as "Change name" and "Move to Trash".

Example of correct Menu options using the short labels "Rename", "Duplicate", and "Delete", and incorrect ones using wordier phrases such as "Change name" and "Move to Trash".

Icons

Prefix
Suffix
  • Include keyboard shortcuts with the KeyboardShortcut component when relevant.

Example of a correct Menu where each option shows a keyboard shortcut as a suffix, such as "Assist" with Shift I and "Code" with Shift C.

Example of a correct Menu where each option shows a keyboard shortcut as a suffix, such as "Assist" with Shift I and "Code" with Shift C.

  • Use the ExternalLink icon when the item links to an external resource. External resources are anything outside of the user's current environment, including:

  • Other Dynatrace environments (from ENV-ID.dynatrace.com to ENV-ID-2.dynatrace.com).

  • Dynatrace documentation or domains (from ENV-ID.dynatrace.com to docs.dynatrace.com).

  • Third-party domains (from ENV-ID.dynatrace.com to anothercompany.com).

A Menu with two options: "Documentation", which carries an external-link icon because it leads outside the environment, and "About this app", which links internally.

A Menu with two options: "Documentation", which carries an external-link icon because it leads outside the environment, and "About this app", which links internally.

When a menu contains a mix of actions, functions, and links:

  • Group similar items together.
  • Separate groups with divider lines.
  • Consider adding section labels for context. See Groups and icons for more details.

Example of a correct Menu where "Edit workflow" and "Delete workflow" are grouped above a divider line, separated from "Share" and "Download".

Example of a correct Menu where "Edit workflow" and "Delete workflow" are grouped above a divider line, separated from "Share" and "Download".

Still have questions?
Find answers in the Dynatrace Community