Skip to content

Commit d4c11e8

Browse files
committed
feat(docs): update Overflwomenu docs single item menu policy
1 parent ef49e2b commit d4c11e8

1 file changed

Lines changed: 9 additions & 2 deletions

File tree

docs/ux/popup-and-overflow-menus.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,18 @@ An established Popup menu pattern used in many user interfaces is the OverflowMe
1414

1515
Use an OverflowMenu when:
1616

17-
- The options or actions in the menu are associated with or targeted at a specific item
17+
- the options or actions in the menu are associated with or targeted at a specific item
18+
- there are multiple options per item
19+
- there is only a single option per item, but showing it inline in the item itself as an icon or button would lead to page clutter, the option is likely rarely to be used, or the action is highly destructive
1820

1921
Do NOT use an overflow item when:
2022

21-
- It is impossible for a user to establish what item or UI element the menu and its options refer to
23+
- it is impossible for a user to establish what item or UI element the menu and its options refer to
24+
- there is only a single option on the item, and that single option is often used so putting it inside menu feels like additional legwork, and/or that single option is not highly destructive
25+
26+
### Bottom Line
27+
28+
When in doubt and to prevent page clutter, it is usually the safer option to also put single item options in an overflow menu, unless the option is very often used, and not destructive. To avoid page clutter, another option is to display the button or icon inline, but only make it appear when hovering the item/row.
2229

2330
When using a PopupMenu, always make sure:
2431

0 commit comments

Comments
 (0)