Save Panel
A Save Panel is the macOS screen for naming a file and choosing where to save or export it. It uses familiar folders and system permissions.
Another example
Exporting a poster opens the system panel. It asks for a file name, folder, format, and overwrite approval.
Main parts
- 01Trigger
- 02Anchored or modal surface
- 03Focus boundary
- 04Dismiss path
Use it when
Use the system panel when people choose a folder, file name, or export format. It also handles Mac access rules, including sandbox app permission.
Do not use it when
Do not build a custom file browser. Do not ask for a location on every autosave. App-owned drafts should save themselves.
Name used in code
AppKit NSSavePanel / SwiftUI fileExporter 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 Save Panel in a native macOS app without breaking platform rules. User context: Exporting a poster opens the system panel. It asks for a file name, folder, format, and overwrite approval. macOS concept or control: Save Panel. Why it fits: Use the system panel when people choose a folder, file name, or export format. It also handles Mac access rules, including sandbox app permission. Do not use it when: Do not build a custom file browser. Do not ask for a location on every autosave. App-owned drafts should save themselves. 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 Save Panel. Definition: A Save Panel is the macOS screen for naming a file and choosing where to save or export it. It uses familiar folders and system permissions. 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.