macOS Search Field
macOS Search Field
Um macOS Search Field é uma caixa de texto feita para buscas. Tem controles do sistema para digitar e limpar a busca e pode mostrar buscas recentes.
Outro exemplo
Digitar um nome de arquivo filtra imediatamente a lista de origem. Escape limpa a consulta e restaura todos os itens.
Partes principais
- 01Rótulo persistente
- 02Input control
- 03Hint or format
- 04Validation message
Use-o quando
Use-o quando palavras digitadas pesquisam ou filtram um conjunto conhecido. Os resultados devem atualizar rapidamente e mostrar estados claros de vazio e limpo.
Não o use quando
Não estilize comandos, filtros aleatórios ou campos de dados exatos como pesquisa. Evite pesquisas ao vivo lentas. Mostre progresso quando os resultados demorarem ou continuarem mudando.
Nome usado no código
AppKit NSSearchField / SwiftUI searchable 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 macOS Search Field (macOS Search Field). User context: Digitar um nome de arquivo filtra imediatamente a lista de origem. Escape limpa a consulta e restaura todos os itens. macOS concept or control: macOS Search Field (macOS Search Field). Why it fits: Use-o quando palavras digitadas pesquisam ou filtram um conjunto conhecido. Os resultados devem atualizar rapidamente e mostrar estados claros de vazio e limpo. Do not use it when: Não estilize comandos, filtros aleatórios ou campos de dados exatos como pesquisa. Evite pesquisas ao vivo lentas. Mostre progresso quando os resultados demorarem ou continuarem mudando. 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 macOS Search Field (macOS Search Field) is used now. Definition: Um macOS Search Field é uma caixa de texto feita para buscas. Tem controles do sistema para digitar e limpar a busca e pode mostrar buscas recentes. 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.