Mac Window
A Mac Window is a work area people can move and resize. It has its own title, controls, focus, and open-to-close life among other windows.
A Mac Window is a work area people can move and resize. It has its own title, controls, focus, and open-to-close life among other windows.
A real example
Each document in a design app has its own window. The app restores every window's size and place after relaunch.
Main parts
- 01Independent title and document identity
- 02Standard window control cluster
- 03Resizable content workspace
- 04Focus, placement, and restoration state
Use it when
Create one when a document or workspace needs its own focus, size, place, saved position, and room beside other work.
Do not use it when
Do not spawn a new window for a brief confirmation, a small contextual tool, or every navigation step. Excessive windows make ownership and cleanup unclear.
Name used in code
AppKit NSWindow / SwiftUI WindowGroup 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 Mac Window in a native macOS app without breaking platform rules. User context: Each document in a design app has its own window. The app restores every window's size and place after relaunch. macOS concept or control: Mac Window. Why it fits: Create one when a document or workspace needs its own focus, size, place, saved position, and room beside other work. Do not use it when: Do not spawn a new window for a brief confirmation, a small contextual tool, or every navigation step. Excessive windows make ownership and cleanup unclear. 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 Mac Window. Definition: A Mac Window is a work area people can move and resize. It has its own title, controls, focus, and open-to-close life among other windows. 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.