Scroll View and Scroller
A Scroll View shows one part of content that is larger than its window. A macOS scroller shows position and supports the mouse, trackpad, and keyboard.
A real example
A long source file scrolls smoothly with a trackpad. The overlay scroller appears only while the person moves through it.
Main parts
- 01Clipped document viewport
- 02Scrollable content coordinate space
- 03Platform scroller and position cue
- 04Mouse, trackpad, and keyboard input path
Use it when
Use the native control when content is larger than its view. It keeps Mac scrolling speed, scroll bars, keyboard movement, and accessibility.
Do not use it when
Avoid scroll areas nested on the same axis. Do not force scroll animations or hide position clues. Respect the person's system settings for wheel input.
Name used in code
AppKit NSScrollView / SwiftUI ScrollView 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 Scroll View and Scroller in a native macOS app without breaking platform rules. User context: A long source file scrolls smoothly with a trackpad. The overlay scroller appears only while the person moves through it. macOS concept or control: Scroll View and Scroller. Why it fits: Use the native control when content is larger than its view. It keeps Mac scrolling speed, scroll bars, keyboard movement, and accessibility. Do not use it when: Avoid scroll areas nested on the same axis. Do not force scroll animations or hide position clues. Respect the person's system settings for wheel input. 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 Scroll View and Scroller. Definition: A Scroll View shows one part of content that is larger than its window. A macOS scroller shows position and supports the mouse, trackpad, and keyboard. 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.