Scroll View and Scroller
捲動檢視與捲軸
捲動檢視（Scroll View）會顯示大於視窗內容的一部分；macOS 捲軸會指出目前位置，並支援滑鼠、觸控板與鍵盤操作。
生活中的例子
長篇原始碼能用觸控板平順捲動。覆疊捲軸只在使用者移動時出現。
主要部分
- 01裁切文件可視區
- 02可捲動內容座標空間
- 03平台捲軸與位置線索
- 04滑鼠、觸控板與鍵盤輸入路徑
什麼時候用
當內容真的超出可視區，而且需要 Mac 的捲動慣性、捲軸、鍵盤操作與無障礙支援時，使用原生控制項。
什麼時候不要用
避免同軸巢狀捲動、強制捲動動畫、隱藏位置線索，或以自訂滾輪處理覆蓋使用者的系統設定。
程式裡的名稱
AppKit NSScrollView / SwiftUI ScrollView 上線前要檢查
檢查支援的 macOS 版本，以及 AppKit 或 SwiftUI 整合。檢查符合平台慣例的焦點與鍵盤操作。再檢查 VoiceOver、完整鍵盤控制、視窗縮放和多視窗狀態。需要時，也要檢查還原、多語系與減少動態效果。
預期成果：在原生 macOS 應用程式中使用或檢查 捲動檢視與捲軸 (Scroll View and Scroller)，並遵守平台慣例。 使用者情境：長篇原始碼能用觸控板平順捲動。覆疊捲軸只在使用者移動時出現。 macOS 概念或控制項：捲動檢視與捲軸 (Scroll View and Scroller)。 適用理由：當內容真的超出可視區，而且需要 Mac 的捲動慣性、捲軸、鍵盤操作與無障礙支援時，使用原生控制項。 不應使用的情況：避免同軸巢狀捲動、強制捲動動畫、隱藏位置線索，或以自訂滾輪處理覆蓋使用者的系統設定。 平台要求：列出支援的 macOS 版本。說明哪些部分由 AppKit 或 SwiftUI 負責，以及兩者如何連接。定義視窗、選單、焦點、鍵盤、狀態保存、還原與多視窗行為。 平台無障礙與韌性：使用正確的無障礙功能介面（Accessibility API）。檢查 VoiceOver 與完整鍵盤控制（Full Keyboard Access）。支援多語系、對比與減少動態效果，並在重新開啟後保留使用者狀態。 驗收條件：在支援的 macOS 版本，用鍵盤與 VoiceOver 檢查行為。視窗縮放、焦點、狀態還原，以及 AppKit 或 SwiftUI 整合都符合 macOS 慣例。 證據與限制（證據邊界）：它只代表該來源的官方說法。其他平台或團隊可能有不同用法。 待確認：支援的 macOS 版本、AppKit 或 SwiftUI 架構、視窗模式、沙盒與應用程式權限限制、資料保留規則，以及無障礙目標。
檢查這份需求
請 AI 程式助手檢查目前如何使用 捲動檢視與捲軸 (Scroll View and Scroller)。 定義：捲動檢視（Scroll View）會顯示大於視窗內容的一部分；macOS 捲軸會指出目前位置，並支援滑鼠、觸控板與鍵盤操作。 正式環境檢查：檢查支援的 macOS 版本，以及 AppKit 或 SwiftUI 整合。檢查符合平台慣例的焦點與鍵盤操作。再檢查 VoiceOver、完整鍵盤控制、視窗縮放和多視窗狀態。需要時，也要檢查還原、多語系與減少動態效果。 修改程式前，先列出看到的證據、缺口、嚴重程度，以及最小且安全的修正。