Scroll View and Scroller
Scroll View and Scroller
Um Scroll View mostra uma parte de um conteúdo que é maior que a janela. Um scroller do macOS mostra a posição e funciona com mouse, trackpad e teclado.
Um exemplo real
Um arquivo de código longo rola suave com o trackpad. A barra de rolagem aparece só enquanto a pessoa se move por ele.
Partes principais
- 01Espaço do documento recortado
- 02Espaço de coordenadas do conteúdo rolável
- 03Rolador da plataforma e indicador de posição
- 04Caminho de entrada do mouse, trackpad e teclado
Use-o quando
Use o controle nativo quando o conteúdo for maior que sua visualização. Ele mantém a velocidade de rolagem do Mac, barras de rolagem, movimentação pelo teclado e acessibilidade.
Não o use quando
Evite áreas de rolagem uma dentro da outra no mesmo sentido. Não force animações ao rolar ou esconda dicas de onde você está. Respeite as configurações de mouse ou trackpad do sistema da pessoa.
Nome usado no código
AppKit NSScrollView / SwiftUI ScrollView Antes de lançar
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: Um arquivo de código longo rola suave com o trackpad. A barra de rolagem aparece só enquanto a pessoa se move por ele. macOS concept or control: Scroll View and Scroller (Scroll View and Scroller). Why it fits: Use o controle nativo quando o conteúdo for maior que sua visualização. Ele mantém a velocidade de rolagem do Mac, barras de rolagem, movimentação pelo teclado e acessibilidade. Do not use it when: Evite áreas de rolagem uma dentro da outra no mesmo sentido. Não force animações ao rolar ou esconda dicas de onde você está. Respeite as configurações de mouse ou trackpad do sistema da pessoa. 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): É oficial para essa fonte. Outras plataformas ou equipes podem usar o termo de outra maneira. 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.
Conferir este pedido
Review how Scroll View and Scroller (Scroll View and Scroller) is used now. Definition: Um Scroll View mostra uma parte de um conteúdo que é maior que a janela. Um scroller do macOS mostra a posição e funciona com mouse, trackpad e 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.