Scroll View and Scroller
Scroll View and Scroller
スクロールビューは、画面より大きなコンテンツの一部を見せる仕組みです。macOSのスクローラーは今の場所を示し、マウスやトラックパッド、キーボードで操作できます。
実際の例
長いソースファイルは、トラックパッドでスムーズにスクロールできるよ。オーバーレイのスクロールバーは、動かしているときだけ現れるよ。
主な部分
- 01クリップされたドキュメントのビューポート
- 02スクロール可能なコンテンツ座標空間
- 03プラットフォームスクローラーと位置指示器
- 04マウス、トラックパッド、キーボードの入力経路
以下の場合に使用します
コンテンツがビューより大きい場合は、ネイティブコントロールを使用します。これにより、Macのスクロール速度、スクロールバー、キーボード操作、アクセシビリティが維持されます。
以下の場合は使用しないでください
同じ軸にネストされたスクロール領域を避ける。スクロールアニメーションを強制したり、位置の手がかりを隠したりしない。ホイール入力に関するユーザーのシステム設定を尊重する。
コードで使用する名前
AppKit NSScrollView / SwiftUI ScrollView 出荷前に
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：Complete the task with Scroll View and Scroller (Scroll View and Scroller)。 User context：長いソースファイルは、トラックパッドでスムーズにスクロールできるよ。オーバーレイのスクロールバーは、動かしているときだけ現れるよ。 macOS concept or control：Scroll View and Scroller (Scroll View and Scroller)。 Why it fits：コンテンツがビューより大きい場合は、ネイティブコントロールを使用します。これにより、Macのスクロール速度、スクロールバー、キーボード操作、アクセシビリティが維持されます。 Do not use it when：同じ軸にネストされたスクロール領域を避ける。スクロールアニメーションを強制したり、位置の手がかりを隠したりしない。ホイール入力に関するユーザーのシステム設定を尊重する。 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)：その情報源にとって公式です。他のプラットフォームやチームはその用語を別の方法で使用する場合があります。 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.
このリクエストを確認する
Review how Scroll View and Scroller (Scroll View and Scroller) is used now. Definition: スクロールビューは、画面より大きなコンテンツの一部を見せる仕組みです。macOSのスクローラーは今の場所を示し、マウスやトラックパッド、キーボードで操作できます。 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, list the evidence, gaps, severity, and the smallest safe fix.