Aller au contenu
SkillCodex
Menu

Search field

Champ de recherche

Un champ de texte dans un formulaire de recherche nommé qui envoie une requête pour trouver du contenu correspondant.

Essayer le composant
Repères, sources et actions
Sources et révision
Mis à jour le
Version
v1.0.26 · r2
Sources
5 sources
Statut
Publié
Consulter les sources

Tu as peut-être cherché : une boîte pour rechercher dans le cataloguesaisir des mots et appuyer sur Entréeune recherche de site avec un bouton effacer

Toutes les formulations
Enregistrer et partager

Reconnaître

Saisir du texte

Essayer

Attend-on une valeur courte, un texte multiligne ou une requête de recherche ?

Champ de recherche

Contexte commun aux essais

Un formulaire recueille du texte, la longueur du contenu et l'intention d'envoi déterminant le contrôle de saisie approprié.

Champ de recherche

Mission

Champ de recherche - Search field

Rechercher dialog, envoyer la requête, puis ouvrir l’un des résultats de concept affichés.

Résultat de l’essai

Aucune recherche active : tous les concepts restent disponibles.

Étape 1 sur 3

Essayer

Manipule le composant. Le résultat de ton essai apparaît juste au-dessus. Avance à ton rythme.

Comportement et cas limite
À observer
La région de recherche nommée contient le champ, l'action visible et le contrôle effacer lorsqu'il est rempli.
Cas limite
Une requête sans correspondance affiche un résultat vide explicite, tandis que l’échec simulé conserve la saisie et propose Réessayer.

Ce que cet essai montre

Search field envoie une requête ; Text field modifie une valeur générale, tandis que Textarea accepte un contenu multiligne.

Lequel convient à ton besoin ?

Champ de recherche

Rechercher dans un site, catalogue ou ensemble de résultats

Champ de texte

Saisir un nom, e-mail, code ou autre valeur courte

Quel composant utilises-tu ici ?
Différence et sources

Search field envoie une requête ; Text field modifie une valeur générale, tandis que Textarea accepte un contenu multiligne.

Consulter les sources

    Parties du spécimen

    Sélectionne un repère numéroté sur le schéma, ou utilise la liste ci-dessous, pour afficher son rôle. Le schéma montre l'état représentatif du concept.

    Libellé

    Le texte persistant qui nomme un contrôle ou un champ.

    Position dans l’atlas

    Carte relationnelle

    Repère le chapitre, les concepts proches et la prochaine décision utile.

    • Chapitre

      Saisir du texte

      Champ de recherche appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Champ de texte

      Choisis Champ de recherche si le texte saisi est une requête sur un site, un catalogue ou un ensemble de résultats. Choisis Champ de texte si la valeur est un nom, un e-mail, un code ou une autre saisie courte conservée comme donnée.

      Comparer cette paire
    • Ne pas confondre

      Zone de texte multiligne

      Choisis Champ de recherche si l’utilisateur cherche quelque chose et attend des résultats, pas un enregistrement. Choisis Zone de texte multiligne si l’utilisateur rédige un message, une note ou une description sur plusieurs lignes.

      Comparer cette paire
    • Prochaine étape

      Compare les concepts du chapitre avant de retenir une implémentation.

      Ouvrir le chapitre

    Avec tes mots

    Comprendre

    Ce que les gens décrivent

    Alias documentés : boîte de recherche, champ de requête, recherche du site

    • une boîte pour rechercher dans le catalogue
    • saisir des mots et appuyer sur Entrée
    • une recherche de site avec un bouton effacer
    • saisir une requête dans l'en-tête
    • trouver des articles avec ce champ
    • un champ de recherche sans options suggérées

    Choisir

    À utiliser quand

    • Rechercher dans un site, catalogue ou ensemble de résultats
    • Fournir un envoi de requête clair et répétable

    À éviter quand

    • Le texte est une propriété générale du formulaire
    • Des suggestions sélectionnables sont nécessaires sans comportement Combobox

    Comparer

    Comparer les concepts proches

    Checklist de vérification

    Essaie ces gestes dans le lab, puis vérifie les mêmes comportements dans le résultat de ton agent. Adapte les noms d’exemple à ton interface.

    1. 1. À faire

      Recherche la même expression une fois avec Entrée et une fois avec le bouton de recherche visible.

      Résultat attendu

      Les deux méthodes lancent la même recherche et produisent le même état de résultats.

    2. 2. À faire

      Efface la recherche avec la commande prévue, puis saisis une nouvelle recherche.

      Résultat attendu

      Le champ est vide et conserve le focus, et le comportement sans recherche est clair avant de recommencer.

    3. 3. À faire

      Valide une expression sans correspondance, puis corrige-la sans quitter le champ.

      Résultat attendu

      L’absence de résultat est annoncée, ta recherche reste modifiable et les nouveaux résultats ne déplacent pas le focus par surprise.

    Contrat complet
    1. 1Le champ appartient à un formulaire de recherche nommé
    2. 2Entrée et l'action visible lancent la même requête
    3. 3Effacer garde le focus et met les résultats à jour
    4. 4Chargement, aucun résultat, erreur et requête vide sont explicites

    Comprendre → Reconnaître → Choisir → Comparer

    Pack pour ton agent

    Instructions pré-écrites à coller dans ton agent. Copier n’exécute rien.

    Implémenter correctement

    Construis Champ de recherche sans casser son comportement

    # Implémenter Champ de recherche dans ton agent
    
    ## Objectif
    Implémente Champ de recherche pour ce comportement vérifié : Un champ de texte dans un formulaire de recherche nommé qui envoie une requête pour trouver du contenu correspondant.
    
    ## Prérequis
    - Inspecte d’abord le dépôt, le design system et les tests existants.
    - Préserve les changements sans rapport et borne les fichiers modifiés.
    - Confirme que Champ de recherche répond au besoin avant de coder.
    
    ## Comportement requis
    - Entrée envoie la requête actuelle via un formulaire de recherche nommé sans changer le pattern du champ.
    - Le contrôle d’effacement vide la requête, garde le focus dans le champ et met les résultats à jour de façon prévisible.
    - Un message précis dans le contexte identifie le champ invalide et explique comment le corriger.
    
    ## États à couvrir
    - Recherche au repos avec une requête vide
    - Requête prête à être envoyée
    - Recherche en cours
    - Résultats visibles
    - Aucun résultat de recherche
    - Erreur de recherche
    - Résultat de recherche ouvert
    
    ## Accessibilité
    - Rôle ARIA : search > input[type=search]
    - Le contrôle principal ou la région nommée pour Champ de recherche possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    - L’envoi laisse le focus dans le formulaire de recherche pendant la mise à jour des résultats ; effacer le rend au champ.
    - Sans objet : les résultats se mettent à jour en ligne ; Effacer retire la requête, les résultats envoyés, l’état ouvert et les erreurs.
    - Le nom de la région, le libellé, la requête, le nombre de résultats, le chargement, aucun résultat et l’erreur sont exposés.
    - Tab focalise le champ
    - Entrée envoie la recherche
    - Tab atteint les contrôles effacer et rechercher
    
    ## Quand ne pas utiliser
    - Le texte est une propriété générale du formulaire
    - Des suggestions sélectionnables sont nécessaires sans comportement Combobox
    
    ## Critères d’acceptation
    - Le champ appartient à un formulaire de recherche nommé
    - Entrée et l’action visible lancent la même requête
    - Effacer garde le focus et met les résultats à jour
    - Chargement, aucun résultat, erreur et requête vide sont explicites
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • Web platform
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le besoin est relié au comportement canonique avant toute décision technique.
    • Les états, l’accessibilité et les non-objectifs empêchent une implémentation seulement visuelle.
    • Les critères d’acceptation et le format de sortie rendent la vérification observable.

    À essayer ensuite

    Vérifie Champ de recherche sur un parcours réel

    # Vérifier Champ de recherche après l’implémentation
    
    ## Objectif
    Audite l’implémentation de Champ de recherche au regard de son comportement, de ses états et de ses exigences d’accessibilité sans la modifier automatiquement.
    
    ## Contrôles
    - Rejoue le plus petit parcours représentatif.
    - Contrôle le clavier, le focus, le nom accessible et les annonces.
    - Relie chaque écart à un critère d’acceptation précis.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:121d3fa03c5d0260091d1433cfa16702e5708d3f6f070662ef728f9b699b7baf

    Diagnostiquer un problème

    Trouve et corrige le défaut de Champ de recherche

    # Déboguer Champ de recherche dans ton agent
    
    ## Symptôme observé
    [DÉCRIS ICI LE SYMPTÔME]
    
    ## Contrôles observables
    - Reproduis le problème avec le plus petit parcours pertinent.
    - Compare le comportement aux états et transitions documentés de Champ de recherche.
    - Vérifie le clavier, le focus, le nom accessible et les annonces.
    
    ## Causes possibles
    - La primitive employée ne correspond pas au comportement attendu.
    - Un état, une transition ou un retour de focus manque.
    - Le composant voisin capture un événement ou masque un signal accessible.
    
    ## Corrections bornées
    - Corrige la cause reproduite sans recréer les composants voisins.
    - Conserve le contrat public et ajoute un test ciblé de non-régression.
    - N’installe aucune dépendance et ne modifie aucun état distant sans autorisation.
    
    ## Vérification finale
    - Le champ appartient à un formulaire de recherche nommé
    - Entrée et l’action visible lancent la même requête
    - Effacer garde le focus et met les résultats à jour
    - Chargement, aucun résultat, erreur et requête vide sont explicites
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • Web platform
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le symptôme explicite évite de partir d’une correction supposée.
    • Les contrôles séparent comportement, accessibilité et interférences voisines.
    • La correction reste bornée et doit produire une preuve de non-régression.

    À essayer ensuite

    Verrouille la correction de Champ de recherche

    # Empêcher la régression de Champ de recherche
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Champ de recherche aux concepts voisins avant d’élargir la correction.
    
    ## Contrôles
    - Prouve que le test échoue avant la correction.
    - Prouve qu’il passe après la correction bornée.
    - Vérifie qu’aucun composant voisin n’a changé de comportement.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:6b1d3ca7772d791c5561e52b91f4c35309f25ed1d485d390a7944ade8cf169be

    Fiche complète, enregistrement et provenance

    Instruction pré-écrite par SkillCodex — ta demande n’est ni envoyée ni utilisée pour adapter ce texte ; aucun contenu n’est généré et copier n’exécute rien.

    Digest du Pack: sha256:55c59314cde67cb54ce571822e1da619650f8116b002ad7c43b41ef6f224e652

    Dans le code

    TechnologiePrimitiveVersionLimite
    Web platform

    form[role=search] with input[type=search]

    NatifUn champ de recherche simple envoie une requête. Des suggestions filtrées sélectionnables transforment l’interaction en Combobox.

    Détails techniques

    Comportements

    • Lancer une recherche

      Entrée envoie la requête actuelle via un formulaire de recherche nommé sans changer le pattern du champ.

    • Effacer la recherche

      Le contrôle d'effacement vide la requête, garde le focus dans le champ et met les résultats à jour de façon prévisible.

    • Expliquer la validation

      Un message précis dans le contexte identifie le champ invalide et explique comment le corriger.

    États

    • Recherche au repos avec une requête vide

      Recherche au repos avec une requête vide

    • Requête prête à être envoyée

      Requête prête à être envoyée

    • Recherche en cours

      Recherche en cours

    • Résultats visibles

      Résultats visibles

    • Aucun résultat de recherche

      Aucun résultat de recherche

    • Erreur de recherche

      Erreur de recherche

    • Résultat de recherche ouvert

      Résultat de recherche ouvert

    Transitions d’état

    • Recherche au repos avec une requête vide → Requête prête à être envoyée

      La saisie de termes significatifs révèle le contrôle effacer et prépare l’envoi explicite.

    • Requête prête à être envoyée → Recherche en cours

      Entrée ou l’action visible Rechercher lance une requête et bloque un envoi en double.

    • Recherche en cours → Résultats visibles

      La requête se termine avec des concepts correspondants et affiche leurs boutons de résultat.

    • Recherche en cours → Aucun résultat de recherche

      La requête se termine sans correspondance et affiche l’état explicite Aucun concept trouvé.

    • Recherche en cours → Erreur de recherche

      La requête d’erreur simulée échoue en conservant la saisie et en affichant Réessayer avec un exemple.

    • Erreur de recherche → Recherche en cours

      Réessayer avec un exemple remplace la requête par raccourcis clavier et lance une nouvelle requête.

    • Résultats visibles → Résultat de recherche ouvert

      L’activation d’un résultat marque ce concept comme ouvert dans la démonstration.

    • Résultats visibles → Requête prête à être envoyée

      La modification de la requête envoyée la prépare pour une nouvelle recherche explicite.

    • Requête prête à être envoyée → Recherche au repos avec une requête vide

      Le contrôle effacer retire la requête tout en conservant le focus dans le champ.

    • Résultats visibles → Recherche au repos avec une requête vide

      Le contrôle effacer retire la requête envoyée et ses résultats tout en conservant le focus.

    • Aucun résultat de recherche → Recherche au repos avec une requête vide

      Le contrôle effacer retire la requête sans correspondance et conserve le focus dans le champ.

    • Résultat de recherche ouvert → Recherche en cours

      Envoyer après l’ouverture d’un résultat efface cet état et lance la requête actuelle.

    • Aucun résultat de recherche → Requête prête à être envoyée

      Modifier une requête envoyée sans correspondance retire le résultat vide et prépare une nouvelle recherche.

    • Erreur de recherche → Requête prête à être envoyée

      Modifier la requête en échec retire l’erreur et prépare un nouvel envoi explicite.

    • Recherche en cours → Requête prête à être envoyée

      Modifier pendant le chargement annule la mise à jour en attente et prépare la requête modifiée.

    • Recherche en cours → Recherche au repos avec une requête vide

      Effacer pendant le chargement annule la mise à jour en attente, vide la requête et conserve le focus.

    • Erreur de recherche → Recherche au repos avec une requête vide

      Effacer retire la requête en échec et l’erreur tout en conservant le focus dans le champ.

    • Résultat de recherche ouvert → Recherche au repos avec une requête vide

      Effacer retire la requête, les résultats et l’état de résultat ouvert tout en conservant le focus dans le champ.

    Scénarios de test

    Contexte
    Un répertoire de concepts recherche des noms de concepts UI connus après un envoi explicite.
    Mission
    Rechercher dialog, envoyer la requête, puis ouvrir l’un des résultats de concept affichés.
    État principal
    La région de recherche nommée contient le champ, l'action visible et le contrôle effacer lorsqu'il est rempli.
    Cas limite
    Une requête sans correspondance affiche un résultat vide explicite, tandis que l’échec simulé conserve la saisie et propose Réessayer.

    Signaux visuels

    • Champ de requête étiqueté ou clairement nommé
    • Action lancer la recherche
    • Contrôle effacer avec une requête

    Signaux comportementaux

    • Entrée envoie la requête actuelle
    • Effacer vide la requête et garde le focus
    • Des suggestions sélectionnables changent le pattern en Combobox

    Accessibilité

    Rôle
    search > input[type=search]
    Nom accessible
    Le contrôle principal ou la région nommée pour Champ de recherche possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    Focus clavier
    L’envoi laisse le focus dans le formulaire de recherche pendant la mise à jour des résultats ; effacer le rend au champ.
    Fermeture
    Sans objet : les résultats se mettent à jour en ligne ; Effacer retire la requête, les résultats envoyés, l’état ouvert et les erreurs.
    Défilement
    Le champ actif, le texte d'aide et le message de validation restent visibles lorsque la page ou un clavier virtuel modifie la zone d'affichage.
    Annonce
    Le nom de la région, le libellé, la requête, le nombre de résultats, le chargement, aucun résultat et l'erreur sont exposés.
    Clavier
    • Tab focalise le champ
    • Entrée envoie la recherche
    • Tab atteint les contrôles effacer et rechercher

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • form[role=search] with input[type=search]

      implementationKind
      native
      nativeElement
      form[role=search] with input[type=search]
      ariaPattern
      search landmark and searchbox
      radixPrimitive
      Non applicable
      shadcnRecipe
      Non applicable
      runtimeDependency
      Non applicable
      packageName
      Non applicable
      exportName
      Non applicable
      exactVersion
      Non applicable
      status
      verified
      sourceId
      source-ui-html-input
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : Un champ de recherche simple envoie une requête. Des suggestions filtrées sélectionnables transforment l’interaction en Combobox.

      Vérifier la source du binding

    Sources

    • WHATWG HTML: The input element
      sourceId
      source-ui-html-input
      kind
      standard
      canonicalUrl
      https://html.spec.whatwg.org/multipage/input.html#the-input-element
      publisher
      WHATWG
      sourceRevision
      http-last-modified:2026-07-19T13:52:46Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:4699d26dbf428296b4b352b480b75c846a9a6b23cf3f124d6d6fe6b5e19d4eba
      status
      verified

      Affirmation couverte : Champ de recherche : sémantique native normative, états, attributs et comportement du navigateur pour input.

    • WHATWG HTML: Forms
      sourceId
      source-ui-html-forms
      kind
      standard
      canonicalUrl
      https://html.spec.whatwg.org/multipage/forms.html
      publisher
      WHATWG
      sourceRevision
      http-last-modified:2026-07-19T13:52:46Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:730c20c8a823ab6b9a40c77d4731d6aab46895cd98c388fe12c966096d5bdd18
      status
      verified

      Affirmation couverte : Champ de recherche : sémantique native normative, états, attributs et comportement du navigateur pour HTML form controls.

    • WAI-ARIA 1.2: Roles Model
      sourceId
      source-ui-wai-aria-roles
      kind
      standard
      canonicalUrl
      https://www.w3.org/TR/wai-aria-1.2/#roles
      publisher
      W3C WAI
      sourceRevision
      W3C-REC-wai-aria-1.2-20230606
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:c0fea16fc747779569ab754d2d25bca3e2b7e8a673b8ef5362aeb9ebc73a4849
      status
      verified

      Affirmation couverte : Champ de recherche : définitions normatives des rôles ARIA et contraintes du rôle accessible indiqué.

    • WCAG 2.2: Focus Appearance
      sourceId
      source-ui-wcag-understanding-focus-appearance
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance.html
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-02T10:07:49Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:fdcf316a1f0e3cc758eda9618322d132862124ff0a3f3b1a3acbf20daf804ff0
      status
      verified

      Affirmation couverte : Champ de recherche : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.

    • WAI-ARIA APG: Combobox Pattern
      sourceId
      source-ui-aria-combobox
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-09T07:07:35Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:d603b09b28e04f4aa72706d55623e781db6001f875a70b97da62f457e92f87e3
      status
      verified

      Affirmation couverte : Champ de recherche : guide APG informatif pour le modèle combobox : rôles, états, relations et interactions au clavier.