Scroll View and Scroller
Scroll View and Scroller
Un Scroll View muestra una parte de un contenido más grande que la ventana. Un scroller de macOS muestra la posición y funciona con ratón, trackpad y teclado.
Un ejemplo real
Un archivo de código largo se desplaza suavemente con el trackpad. La barra de desplazamiento solo aparece mientras la persona se mueve por ahí.
Partes principales
- 01Ventana del documento recortada
- 02Espacio de coordenadas de contenido desplazable
- 03Scroll de la plataforma y señal de posición
- 04Ruta de entrada de ratón, trackpad y teclado
Úsalo cuando
Usa el control nativo cuando el contenido sea más grande que su vista. Mantiene la velocidad de desplazamiento de Mac, las barras de desplazamiento, el movimiento del teclado y la accesibilidad.
No lo uses cuando
Evita áreas de desplazamiento dentro de otras en la misma dirección. No fuerces animaciones al desplazarte ni ocultes referencias de dónde estás. Respeta la configuración del sistema para la rueda del mouse.
Nombre usado en código
AppKit NSScrollView / SwiftUI ScrollView Antes de lanzarlo
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: Un archivo de código largo se desplaza suavemente con el trackpad. La barra de desplazamiento solo aparece mientras la persona se mueve por ahí. macOS concept or control: Scroll View and Scroller (Scroll View and Scroller). Why it fits: Usa el control nativo cuando el contenido sea más grande que su vista. Mantiene la velocidad de desplazamiento de Mac, las barras de desplazamiento, el movimiento del teclado y la accesibilidad. Do not use it when: Evita áreas de desplazamiento dentro de otras en la misma dirección. No fuerces animaciones al desplazarte ni ocultes referencias de dónde estás. Respeta la configuración del sistema para la rueda del mouse. 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): Es oficial para esa fuente. Otras plataformas o equipos pueden usar el término de otra manera. 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.
Revisa esta petición
Review how Scroll View and Scroller (Scroll View and Scroller) is used now. Definition: Un Scroll View muestra una parte de un contenido más grande que la ventana. Un scroller de macOS muestra la posición y funciona con ratón, trackpad y teclado. 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.