Save Panel
儲存面板
儲存面板(Save Panel)是 macOS 用來命名檔案,以及選擇儲存或匯出位置的系統介面,會使用熟悉的資料夾與系統權限。
另一個例子
匯出海報時,系統會開啟儲存面板。它會詢問檔名、資料夾、格式和覆寫確認。
主要部分
- 01觸發物
- 02錨定或模態表面
- 03焦點邊界
- 04關閉方式
什麼時候用
當使用者要選資料夾、檔名或匯出格式時,使用系統面板。它也會處理 Mac 的檔案存取規則,包括沙盒 App 的權限。
什麼時候不要用
不要自製檔案瀏覽器、每次自動儲存都詢問位置,或讓本應自動保留的 App 內部草稿經過儲存面板。
程式裡的名稱
AppKit NSSavePanel / SwiftUI fileExporter 上線前要檢查
檢查支援的 macOS 版本,以及 AppKit 或 SwiftUI 整合。檢查符合平台慣例的焦點與鍵盤操作。再檢查 VoiceOver、完整鍵盤控制、視窗縮放和多視窗狀態。需要時,也要檢查還原、多語系與減少動態效果。
預期成果:在原生 macOS 應用程式中使用或檢查 儲存面板 (Save Panel),並遵守平台慣例。 使用者情境:匯出海報時,系統會開啟儲存面板。它會詢問檔名、資料夾、格式和覆寫確認。 macOS 概念或控制項:儲存面板 (Save Panel)。 適用理由:當使用者要選資料夾、檔名或匯出格式時,使用系統面板。它也會處理 Mac 的檔案存取規則,包括沙盒 App 的權限。 不應使用的情況:不要自製檔案瀏覽器、每次自動儲存都詢問位置,或讓本應自動保留的 App 內部草稿經過儲存面板。 平台要求:列出支援的 macOS 版本。說明哪些部分由 AppKit 或 SwiftUI 負責,以及兩者如何連接。定義視窗、選單、焦點、鍵盤、狀態保存、還原與多視窗行為。 平台無障礙與韌性:使用正確的無障礙功能介面(Accessibility API)。檢查 VoiceOver 與完整鍵盤控制(Full Keyboard Access)。支援多語系、對比與減少動態效果,並在重新開啟後保留使用者狀態。 驗收條件:在支援的 macOS 版本,用鍵盤與 VoiceOver 檢查行為。視窗縮放、焦點、狀態還原,以及 AppKit 或 SwiftUI 整合都符合 macOS 慣例。 證據與限制(證據邊界):它只代表該來源的官方說法。其他平台或團隊可能有不同用法。 待確認:支援的 macOS 版本、AppKit 或 SwiftUI 架構、視窗模式、沙盒與應用程式權限限制、資料保留規則,以及無障礙目標。
檢查這份需求
請 AI 程式助手檢查目前如何使用 儲存面板 (Save Panel)。 定義:儲存面板(Save Panel)是 macOS 用來命名檔案,以及選擇儲存或匯出位置的系統介面,會使用熟悉的資料夾與系統權限。 正式環境檢查:檢查支援的 macOS 版本,以及 AppKit 或 SwiftUI 整合。檢查符合平台慣例的焦點與鍵盤操作。再檢查 VoiceOver、完整鍵盤控制、視窗縮放和多視窗狀態。需要時,也要檢查還原、多語系與減少動態效果。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。