[All hosts] (ribbon) Document scaling behavior #5262
Conversation
|
Learn Build status updates of commit 83be1d4: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Learn Build status updates of commit f0733c7: ✅ Validation status: passed
For more details, please refer to the build report. |
|
Learn Build status updates of commit 8aa5c67: ✅ Validation status: passed
For more details, please refer to the build report. |
There was a problem hiding this comment.
Pull Request Overview
This PR updates the add-in commands documentation to refine terminology around dropdown menus and introduce a detailed section on how grouped add-in commands scale and adapt to space constraints on the ribbon.
- Bumped the document’s ms.date to July 15, 2025
- Standardized “dropdown” terminology and updated related headings
- Added a “Grouped add-in commands on the ribbon” section describing icon sizing, label visibility, and overflow behavior
| ### Dropdown menu | ||
|
|
||
| A drop-down menu add-in command defines a static list of items. The menu can be any mix of items that execute a function or that open a task pane. Submenus aren't supported. | ||
| A dropdown menu add-in command defines a static list of items. The menu can be any mix of items that execute a function or that open a task pane. Submenus aren't supported. | ||
|
|
||
|  | ||
|
|
||
| ### Grouped add-in commands on the ribbon | ||
|
|
||
| Multiple add-in commands can be grouped together on the ribbon. A group must contain at least one add-in command in the form of a button or a dropdown menu. In Office on Windows and on Mac, the label and icon of a button or dropdown menu are usually shown for add-in commands in a group. However, the icon size and label visibility may vary due to the following factors that constrain space. |
There was a problem hiding this comment.
[nitpick] The term "dropdown" is used inconsistently in the doc (previously hyphenated as "drop-down"). Consider choosing a single style and applying it consistently throughout.
Copilot uses AI. Check for mistakes.
| 1. Only small icons are shown. | ||
| 1. The group is displayed as a dropdown menu instead of showing individual add-in commands on the ribbon. A scroll slider icon also appears on the ribbon, so that you can scroll through the ribbon. |
There was a problem hiding this comment.
[nitpick] Since this is an ordered sequence, consider numbering the steps as 1, 2, 3 instead of repeating "1." to improve reader clarity.
| 1. Only small icons are shown. | |
| 1. The group is displayed as a dropdown menu instead of showing individual add-in commands on the ribbon. A scroll slider icon also appears on the ribbon, so that you can scroll through the ribbon. | |
| 2. Only small icons are shown. | |
| 3. The group is displayed as a dropdown menu instead of showing individual add-in commands on the ribbon. A scroll slider icon also appears on the ribbon, so that you can scroll through the ribbon. |
Copilot uses AI. Check for mistakes.
Co-authored-by: Rick Kirkham <[email protected]>
|
Learn Build status updates of commit 7f1365a: ✅ Validation status: passed
For more details, please refer to the build report. |
No description provided.