IntelliJ Platform Plugin SDK Help

Toolbar Drop-Down List

A toolbar drop-down list is a type of button that appears on a horizontal toolbar and shows a list of choices on clicking it.

Toolbar dropdown example

When to use

Use toolbar drop-down if a single option should be selected.

If the choices are objects or states.

To select values that are controlled by the toolbar button on the right.

Toolbar main

To filter values or change the appearance in the control below:

Toolbar filter

Use a toolbar drop-down button instead of a drop-down list in the following cases:

  • If there is a list of actions:

Toolbar dropdown menu button
  • The options are secondary and the user won’t change them in most cases.

  • Multi-selection is required, for example, to group by several attributes.

Do not use toolbar drop-down in dialogs, use the drop-down list instead.

Incorrect

Correct

Settings incorrect
Settings correct

How to use

Do not add a label to the toolbar drop-down.

For the default value, follow the rules for the drop-down list.

Add separators between the toolbar drop-down and icons:

Diff

If a drop-down is controlled by buttons, add a border, as separators will break the connection between the controlling icons and the drop-down:

Toolbar main

The toolbar drop-down does not get the focus. Highlight it on hover the same way as toolbar icons.

Toolbar dropdown hover

Control

Open the drop-down menu when clicking anywhere on a drop-down list. Open the menu down by default. If there is not enough space, open the menu up.

Select the first option when the menu opens.

Move the selection in the menu on pressing the Up and Down arrows or on hovering the cursor over the item.

Filter items in the list on typing:

Search

Close the menu if the user selects an item, clicks outside the menu, presses the Esc key or switches to another app.

Allow single-click activation using mouse: click on a drop-down, the drop-down opens, select an item by hovering, close the drop-down with the new item selected by releasing the mouse button.

Follow the rules for the drop-down list.

If it’s necessary to configure options in a toolbar drop-down list, add customization actions at the top or at the bottom of the list and separate them with a line. Use title case capitalization for actions.

Toolbar dropdown customize

A toolbar drop-down list can have submenus.

A submenu is a menu item that shows a list of nested items. A submenu includes a triangular indicator that distinguishes it from other menu items.

Use item submenus to group related options and to show hierarchy:

Submenu example

Show the submenu list on hovering over an item.

If the selection moves with the Up and Down arrow keys, show the submenu list on pressing the Right arrow or the Enter key.

Avoid submenus inside submenus. Submenus hide choices too deep and are difficult to navigate.

Sizes and placement

Toolbar drop-down sizes are the same for all themes.

Toolbar dropdown sizes

The width changes depending on the selected value to save space if the value is short.

Toolbar dropdown width

For menu sizes see Drop-down menu.

Last modified: 16 May 2024