macOS Search Field
macOS Search Field
macOS Search Field는 검색을 위해 만든 입력칸이에요. 검색어를 적고 지우는 시스템 컨트롤이 있고, 최근 검색어를 보여주기도 해요.
다른 예시
파일 이름을 입력하면 소스 목록이 즉시 필터링됩니다. Escape 키를 누르면 쿼리가 제거되고 모든 항목이 복원됩니다.
주요 부분
- 01지속 라벨
- 02Input control
- 03Hint or format
- 04Validation message
사용할 때
입력한 단어로 기존 집합을 검색하거나 필터링할 때 사용하세요. 결과는 빠르게 업데이트되어야 하며, 비어 있음과 초기화된 상태를 명확하게 보여야 합니다.
다음 경우에는 사용하지 마세요
명령어, 랜덤 필터, 정확한 데이터 필드를 검색으로 스타일링하지 마세요. 느린 라이브 검색은 피하세요. 결과가 오래 걸리거나 계속 바뀔 때는 진행 상황을 보여주세요.
코드에서 사용된 이름
AppKit NSSearchField / SwiftUI searchable 출시하기 전에
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 macOS Search Field (macOS Search Field)。 User context：파일 이름을 입력하면 소스 목록이 즉시 필터링됩니다. Escape 키를 누르면 쿼리가 제거되고 모든 항목이 복원됩니다. macOS concept or control：macOS Search Field (macOS Search Field)。 Why it fits：입력한 단어로 기존 집합을 검색하거나 필터링할 때 사용하세요. 결과는 빠르게 업데이트되어야 하며, 비어 있음과 초기화된 상태를 명확하게 보여야 합니다. 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 macOS Search Field (macOS Search Field) is used now. Definition: macOS Search Field는 검색을 위해 만든 입력칸이에요. 검색어를 적고 지우는 시스템 컨트롤이 있고, 최근 검색어를 보여주기도 해요. 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.