Unified Title Bar Toolbar
A Unified Title Bar Toolbar is a command row built into the window title area. People can change it, and it holds common document or view actions.
A real example
A notes app combines sidebar toggle, search, share, and formatting tools in one draggable title-bar region.
Main parts
- 01Unified title-and-drag region
- 02Window command item groups
- 03Selection-aware item state
- 04Customization and overflow path
Use it when
Use it for common commands tied to the current window when direct access and custom choice help the work below.
Do not use it when
Do not crowd it with rare or destructive commands. Selection-dependent items can remain in place and update their enabled or selected state. Avoid needless layout shifts, and keep essential commands discoverable in the menu bar.
Name used in code
AppKit NSToolbar / SwiftUI toolbar Before you ship
Check the supported macOS versions and AppKit or SwiftUI integration. Check standard focus and keyboard behavior. Also check VoiceOver, Full Keyboard Access, window resizing, and multi-window state. When needed, check restore, localization, and reduced motion.
Outcome: Apply or review Unified Title Bar Toolbar in a native macOS app without breaking platform rules. User context: A notes app combines sidebar toggle, search, share, and formatting tools in one draggable title-bar region. macOS concept or control: Unified Title Bar Toolbar. Why it fits: Use it for common commands tied to the current window when direct access and custom choice help the work below. Do not use it when: Do not crowd it with rare or destructive commands. Selection-dependent items can remain in place and update their enabled or selected state. Avoid needless layout shifts, and keep essential commands discoverable in the menu bar. Platform requirements: List the supported macOS versions. Say whether AppKit or SwiftUI owns each part and how they connect. Define window, menu, focus, keyboard, saved state, restore, and multi-window behavior. Platform accessibility and resilience: Use the right accessibility APIs. Check VoiceOver and Full Keyboard Access. Support localization, contrast, and reduced motion when needed. Keep user state after a relaunch. Acceptance criteria: Check the behavior on supported macOS versions with a keyboard and VoiceOver. Window resizing, focus, state restore, and AppKit or SwiftUI integration work in the normal macOS way. Evidence and limits (evidence boundary): It is official for that source. Other platforms or teams may use the term in another way. Unknowns to confirm: Supported macOS versions, AppKit or SwiftUI structure, and window model. Also confirm sandbox and entitlement limits, save rules, and the accessibility goal.
Check this request
Review the current use of Unified Title Bar Toolbar. Definition: A Unified Title Bar Toolbar is a command row built into the window title area. People can change it, and it holds common document or view actions. Release checks: Check the supported macOS versions and AppKit or SwiftUI integration. Check standard focus and keyboard behavior. Also check VoiceOver, Full Keyboard Access, window resizing, and multi-window state. When needed, check restore, localization, and reduced motion. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.