Rechercher
Saisissez au moins deux caractères, sans donnée personnelle.

    BibliothèqueArticles et FAQ Votre projetDemander un devis
    LangueFR
    Guides pratiques

    Concevoir une autocomplétion pour choisir une valeur

    L’autocomplétion propose des valeurs pendant la saisie. Elle peut aider à choisir une commune ou un produit dans une longue liste. Sa valeur dépend aussi de la qualité des données et de ce qui se passe lorsqu’aucune suggestion ne correspond au besoin.

    Voir la méthode

    Téléphone présentant des suggestions près d’une carte
    Illustration générée par IA

    Définir ce qu’une saisie signifie

    Décidez si le champ accepte un texte libre ou exige une entrée du catalogue. Expliquez cette règle près du libellé. Une chaîne saisie ne constitue pas automatiquement une sélection : pour un identifiant de commune, le formulaire doit connaître l’entrée choisie et pas seulement son nom affiché.

    Préparez les homonymes avec un complément utile, par exemple le département, sans demander de données inutiles. Définissez le traitement des accents, des tirets et des noms alternatifs à partir du catalogue. Ne remplacez pas silencieusement la valeur par la première suggestion lorsque plusieurs réponses restent possibles.

    Permettre de parcourir puis de confirmer

    Le modèle de combobox W3C décrit un champ associé à une liste proposée, avec des interactions pour explorer, accepter ou quitter les suggestions. L’ouverture et le choix actif doivent être communiqués. Les commandes ordinaires d’édition du texte doivent rester utilisables.

    Gardez la différence entre proposition mise en évidence et valeur confirmée. Lorsque la personne ferme la liste, elle doit comprendre ce qui sera envoyé. Testez le choix au clavier, la correction du texte après sélection et la sortie du champ sans avoir accepté une option.

    Pour une autocomplétion éditable avec liste et sélection manuelle, gardez le focus DOM dans le champ. aria-activedescendant peut désigner l’option explorée ; sa valeur doit correspondre à un identifiant réellement présent dans la liste courante. Mettez aria-expanded à jour à l’ouverture et à la fermeture. Une option visuellement active, le texte saisi et l’identifiant métier accepté sont trois informations différentes : consignez-les séparément dans le test.

    Définissez explicitement le contrat de sélection manuelle : parcourir une suggestion ne l’enregistre pas ; Entrée l’accepte, et Échap ferme ici la liste sans effacer la saisie. Ce choix ne décrit pas toutes les variantes de combobox, certaines acceptant automatiquement une suggestion à la sortie du champ. Après modification d’un libellé déjà choisi, invalidez l’ancien identifiant tant qu’une nouvelle correspondance n’est pas confirmée, si le formulaire exige une entrée du catalogue.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Autocomplétion manuelle : explorer sans enregistrer par erreur
    Action dans la variante retenueÉtat à contrôlerEnvoi métier
    Explorer avec les flèchesL’option active change ; le focus DOM reste dans le champ.Aucun nouvel identifiant n’est confirmé par ce seul déplacement.
    Accepter avec EntréeLe libellé et l’identifiant correspondent à l’option acceptée.L’identifiant choisi devient la valeur à valider côté serveur.
    Fermer avec ÉchapLa liste se ferme ; la saisie est conservée dans cette variante.Aucune suggestion supplémentaire n’est acceptée.
    Modifier le texte après sélectionL’ancien identifiant ne reste pas associé au nouveau texte sans validation.Un choix de catalogue reste nécessaire si le champ l’exige.
    • W3C APG : Combobox

      Recommandations consultées le 22 octobre 2026 ; grille limitée à une liste éditable avec sélection manuelle, sans effacement par Échap.

    Gérer le réseau et les données du catalogue

    Une réponse lente à une ancienne saisie ne doit pas remplacer les suggestions d’une saisie plus récente. Prévoyez attente, absence de résultat et erreur de service comme trois états distincts. Offrez une autre manière de poursuivre si la suggestion est une commodité et non une condition indispensable.

    Une entrée retirée entre sélection et envoi demande une validation côté serveur et une réponse exploitable. Conservez les autres champs pour permettre de choisir une nouvelle valeur. Si des résultats sont limités, expliquez qu’il faut préciser la recherche plutôt que d’annoncer une liste complète qui ne l’est pas.

    Exemple : distinguer des communes homonymes

    Exemple pédagogique : la saisie retourne deux communes du même nom dans des départements différents. Les suggestions affichent nom et département ; l’envoi utilise l’identifiant choisi. Le test sélectionne la seconde, corrige ensuite le texte et vérifie que l’ancien identifiant n’est pas conservé par erreur. Un autre essai bloque le réseau pour vérifier la possibilité de reprendre.

    Empêcher une ancienne recherche de remplacer les suggestions de la saisie actuelle.

    Cas fictif : une personne saisit « musée », puis « musique », sur une connexion lente. Retardez la première réponse dans un environnement de test. Annulez l’opération précédente et contrôlez aussi l’identifiant de la recherche active avant d’afficher sa réponse. Une annulation dans le navigateur ne prouve pas que le serveur a annulé son traitement.

    • Seules les suggestions de la dernière saisie apparaissent ; l’annulation ne déclenche pas un message d’échec trompeur.
    • MDN AbortController

      API de contrôle permettant d’annuler des opérations asynchrones, notamment des requêtes Fetch et la lecture de leur réponse.

    Documents de référence

    Contenu mis à jour le

    Matrice de recette à adapter au projet

    Ces contrôles proposés utilisent des cas fictifs. Décidez du comportement attendu avec l’équipe, notez le résultat et attribuez les écarts non résolus avant publication.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Cas de test, résultats attendus et preuves utiles
    CasRésultat attenduPreuve à conserver
    Nom partagéLes propositions peuvent être distinguéesDeux homonymes fictifs, libellés distinctifs et identifiant réellement associé au choix.
    Réponses désordonnéesSeules les suggestions de la saisie actuelle apparaissentSéquence de requêtes de test
    Saisie modifiée après choixLe texte et l’identifiant restent cohérentsValeur affichée et valeur transmise
    Aucun résultatUne explication et une issue existentMessage et action suivante

    Questions fréquentes

    Pourquoi ne pas sélectionner la première réponse automatiquement ?

    Une suggestion n’est pas forcément le choix de la personne. Une sélection silencieuse peut envoyer la mauvaise commune ou le mauvais produit.

    Le texte visible suffit-il à identifier une entrée ?

    Pas si les noms peuvent se répéter ou changer. Utilisez une référence stable et contrôlez la cohérence avec la valeur montrée.

    Faut-il une autocomplétion pour une liste courte ?

    Un champ select natif ou des choix visibles peuvent être plus simples. Comparez l’effort de sélection et la fréquence d’usage avant de développer une liste personnalisée.