Scroll View and Scroller
Scroll View and Scroller
Scroll View는 창보다 큰 내용의 일부분만 보여줘. macOS scroller는 위치를 알려주고 마우스, 트랙패드, 키보드를 모두 지원해.
실제 예시
긴 소스 파일도 트랙패드로 부드럽게 스크롤돼요. 화면을 움직일 때만 스크롤 막대가 나타나요.
주요 부분
- 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: Scroll View는 창보다 큰 내용의 일부분만 보여줘. macOS scroller는 위치를 알려주고 마우스, 트랙패드, 키보드를 모두 지원해. 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.