Apple HIG: Menus and Buttons
Selective Reading Rule
Start with:
references/usage-routing.mdreferences/quality-checklist.md
Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.
Selective Reading Rule
Start with:
references/senior-master-standard.md
Then load only the references, scripts, assets, or examples needed for the user's actual task.
Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.
Key Principles
Menus should be contextual and predictable. Standard items in standard locations. Follow platform conventions for ordering and grouping.
Use standard button styles. System-defined styles communicate affordance and maintain visual consistency. Prefer them over custom designs.
Toolbars for frequent actions. Most commonly used commands in the toolbar. Rarely used actions belong in menus.
Menu bar is the primary command interface on macOS. Every command reachable from the menu bar. Toolbars and context menus supplement, not replace.
Context menus for secondary actions. Right-click or long-press, relevant to the item under the pointer. Never put a command only in a context menu.
Pop-up buttons for mutually exclusive choices. Select exactly one option from a set.
Pull-down buttons for action lists. No current selection; they offer a set of commands.
Action buttons consolidate related actions behind a single icon in toolbars or title bars.
Disclosure controls for progressive disclosure. Show or hide additional content.
Dock menus: short and focused on the most useful actions when the app is running.
Reference Index
| Reference |
Topic |
Key content |
| menus.md |
General menu design |
Item ordering, grouping, shortcuts |
| context-menus.md |
Context menus |
Right-click, long press, secondary actions |
| dock-menus.md |
Dock menus |
macOS app-level actions, running state |
| edit-menus.md |
Edit menus |
Undo, copy, paste, standard items |
| the-menu-bar.md |
Menu bar |
macOS primary command interface, structure |
| toolbars.md |
Toolbars |
Frequent actions, customization, placement |
| buttons.md |
Buttons |
System styles, sizing, affordance |
| action-button.md |
Action button |
Grouped secondary actions, toolbar use |
| pop-up-buttons.md |
Pop-up buttons |
Mutually exclusive choice selection |
| pull-down-buttons.md |
Pull-down buttons |
Action lists, no current selection |
| disclosure-controls.md |
Disclosure controls |
Progressive disclosure, show/hide |
Output Format
- Component recommendation -- which menu or button type and why.
- Visual hierarchy -- placement, sizing, grouping within the interface.
- Platform-specific behavior across iOS, iPadOS, macOS, visionOS.
- Keyboard shortcuts (macOS) -- standard and custom shortcuts for menu items and toolbar actions.
Questions to Ask
- Which platforms?
- Primary or secondary action?
- How many actions need to be available?
- macOS menu bar app?
Related Skills
- hig-components-search -- Search fields, page controls alongside toolbars and menus
- hig-components-controls -- Toggles, pickers, segmented controls complementing buttons
- hig-components-dialogs -- Alerts, sheets, popovers triggered by menu items or buttons
- hig-inputs -- Keyboard shortcuts and pointer interactions with menus and toolbars
Built by Raintree Technology · More developer tools
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: hig-components-menus3description: ALWAYS use this when the request matches HIG Components Menus: Check for .claude/apple-design-context.md before asking questions.4---56# Apple HIG: Menus and Buttons78## Selective Reading Rule910Start with:1112- `references/usage-routing.md`13- `references/quality-checklist.md`1415Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.1617## Selective Reading Rule1819Start with:2021- `references/senior-master-standard.md`2223Then load only the references, scripts, assets, or examples needed for the user's actual task.242526Check for `.claude/apple-design-context.md` before asking questions. Use existing context and only ask for information not already covered.2728## Key Principles29301. **Menus should be contextual and predictable.** Standard items in standard locations. Follow platform conventions for ordering and grouping.31322. **Use standard button styles.** System-defined styles communicate affordance and maintain visual consistency. Prefer them over custom designs.33343. **Toolbars for frequent actions.** Most commonly used commands in the toolbar. Rarely used actions belong in menus.35364. **Menu bar is the primary command interface on macOS.** Every command reachable from the menu bar. Toolbars and context menus supplement, not replace.37385. **Context menus for secondary actions.** Right-click or long-press, relevant to the item under the pointer. Never put a command only in a context menu.39406. **Pop-up buttons for mutually exclusive choices.** Select exactly one option from a set.41427. **Pull-down buttons for action lists.** No current selection; they offer a set of commands.43448. **Action buttons consolidate related actions** behind a single icon in toolbars or title bars.45469. **Disclosure controls for progressive disclosure.** Show or hide additional content.474810. **Dock menus: short and focused** on the most useful actions when the app is running.4950## Reference Index5152| Reference | Topic | Key content |53|---|---|---|54| [menus.md](references/menus.md) | General menu design | Item ordering, grouping, shortcuts |55| [context-menus.md](references/context-menus.md) | Context menus | Right-click, long press, secondary actions |56| [dock-menus.md](references/dock-menus.md) | Dock menus | macOS app-level actions, running state |57| [edit-menus.md](references/edit-menus.md) | Edit menus | Undo, copy, paste, standard items |58| [the-menu-bar.md](references/the-menu-bar.md) | Menu bar | macOS primary command interface, structure |59| [toolbars.md](references/toolbars.md) | Toolbars | Frequent actions, customization, placement |60| [buttons.md](references/buttons.md) | Buttons | System styles, sizing, affordance |61| [action-button.md](references/action-button.md) | Action button | Grouped secondary actions, toolbar use |62| [pop-up-buttons.md](references/pop-up-buttons.md) | Pop-up buttons | Mutually exclusive choice selection |63| [pull-down-buttons.md](references/pull-down-buttons.md) | Pull-down buttons | Action lists, no current selection |64| [disclosure-controls.md](references/disclosure-controls.md) | Disclosure controls | Progressive disclosure, show/hide |6566## Output Format67681. **Component recommendation** -- which menu or button type and why.692. **Visual hierarchy** -- placement, sizing, grouping within the interface.703. **Platform-specific behavior** across iOS, iPadOS, macOS, visionOS.714. **Keyboard shortcuts** (macOS) -- standard and custom shortcuts for menu items and toolbar actions.7273## Questions to Ask74751. Which platforms?762. Primary or secondary action?773. How many actions need to be available?784. macOS menu bar app?7980## Related Skills8182- **hig-components-search** -- Search fields, page controls alongside toolbars and menus83- **hig-components-controls** -- Toggles, pickers, segmented controls complementing buttons84- **hig-components-dialogs** -- Alerts, sheets, popovers triggered by menu items or buttons85- **hig-inputs** -- Keyboard shortcuts and pointer interactions with menus and toolbars8687---8889*Built by [Raintree Technology](https://raintree.technology) · [More developer tools](https://raintree.technology)*9091## When to Use92This skill is applicable to execute the workflow or actions described in the overview.9394## Limitations95- Use this skill only when the task clearly matches the scope described above.96- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.97- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
anhvu1107