Interface macOS Plus de détails B · Orientation officielle Plateforme: macOS

macOS Search Field

macOS Search Field

Un macOS Search Field est une zone de texte faite pour chercher. Il a des contrôles système pour saisir et effacer une requête, et peut afficher les recherches récentes.

Vous pourriez l'appeler macOS Search Fieldchamp de rechercheNSSearchFieldsearchable

Voir comment cela fonctionne

Exemple travaillé originalmacOS Search Field

Un autre exemple

La saisie d'un nom de fichier filtre immédiatement la liste source. Échap efface la requête et restaure tous les éléments.

Parties principales

  1. 01Étiquette persistante
  2. 02Input control
  3. 03Hint or format
  4. 04Validation message

Utilisez-le lorsque

Utilisez-le lorsque des mots tapés recherchent ou filtrent un ensemble connu. Les résultats doivent se mettre à jour rapidement et montrer clairement les états vide et effacé.

Ne l'utilisez pas lorsque

Ne formatez pas les commandes, filtres aléatoires ou champs de données exacts comme une recherche. Évitez les recherches en direct lentes. Montrez la progression lorsque les résultats prennent du temps ou continuent de changer.

Nom utilisé dans le code

AppKit NSSearchField / SwiftUI searchable

Avant d'expédier

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.

Demande que vous pouvez copier

Outcome: Complete the task with macOS Search Field (macOS Search Field). User context: La saisie d'un nom de fichier filtre immédiatement la liste source. Échap efface la requête et restaure tous les éléments. macOS concept or control: macOS Search Field (macOS Search Field). Why it fits: Utilisez-le lorsque des mots tapés recherchent ou filtrent un ensemble connu. Les résultats doivent se mettre à jour rapidement et montrer clairement les états vide et effacé. Do not use it when: Ne formatez pas les commandes, filtres aléatoires ou champs de données exacts comme une recherche. Évitez les recherches en direct lentes. Montrez la progression lorsque les résultats prennent du temps ou continuent de changer. 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): C'est officiel pour cette source. D'autres plateformes ou équipes peuvent utiliser le terme d'une autre manière. 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.

Vérifiez cette demande

Review how macOS Search Field (macOS Search Field) is used now. Definition: Un macOS Search Field est une zone de texte faite pour chercher. Il a des contrôles système pour saisir et effacer une requête, et peut afficher les recherches récentes. 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.

B
Ce terme est-il officiel ?

Orientation officielle

La plateforme, le framework, le projet ou le groupe d'experts nommé dispose d'un guide officiel pour ce terme.

C'est officiel pour cette source. D'autres plateformes ou équipes peuvent utiliser le terme d'une autre manière.

Portée
Seulement ce que couvre la source:nom canonique、définition、API de la plateforme、mise en œuvre、guide d'utilisation
Statut du document
stable
Coché activé
2026-07-30

Sources et portée des preuves

Source faisant autorité · Apple · stable Search fields Portée: nom canonique、définition、API de la plateforme、mise en œuvre、guide d'utilisation Rôle ici: Autorité dans le cadre indiqué La source couvre: nom canonique, définition, API de la plateforme, mise en œuvre, guide d'utilisation Source de l’arrière-plan Apple Human Interface Guidelines — Designing for macOS Rôle ici: Contexte utile, pas une définition

Copiez-le vous-même

Le navigateur n'a pas pu copier ceci. Sélectionnez la requête ci-dessous et copiez-la vous-même.