path: root/files/fr/web/html/attributs/autocomplete/index.html

---
title: autocomplete
slug: Web/HTML/Attributs/autocomplete
tags:
  - Attribut
  - HTML
  - Input
  - Reference
translation_of: Web/HTML/Attributes/autocomplete
---
<div>{{HTMLSidebar("Global_attributes")}}</div>

<p>L'attribut <code>autocomplete</code> est disponible pour différents types d'éléments {{HTMLElement("input")}}, {{HTMLElement("textarea")}}, {{HTMLElement("select")}} et {{HTMLElement("form")}}. <span class="seoSummary"><code>autocomplete</code> permet d'indiquer à l'agent utilisateur qu'une assistance de saisie automatique peut être fournie et également d'indiquer le type de donnée attendu.</span></p>

<p>La source fournissant les valeurs suggérées pour l'autocomplétion dépend du navigateur. Généralement, celle-ci est constituée des valeurs saisies précédemment par l'utilisateur. Ce peuvent également être des valeurs préconfigurées. Ainsi, un navigateur pourra permettre à un utilisateur d'enregistrer son nom, son adresse, son numéro de téléphone et des adresses électroniques pour l'aider lors de l'autocomplétion. Le navigateur pourrait également fournir le stockage chiffré des informations de cartes bancaires et déclencher une procédure d'authentification lorsque ces informations doivent être récupérées pour être utilisées.</p>

<p>Si l'élément {{HTMLElement("input")}}, {{HTMLElement("select")}} ou {{HTMLElement("textarea")}} ne possèdent pas d'attribut <code>autocomplete</code>, le navigateur utilisera l'attribut <code>autocomplete</code> du formulaire associé (c'est-à-dire l'élément {{HTMLElement("form")}} qui est l'ancêtre de l'élément <code>&lt;input&gt;</code> ou l'élément <code>&lt;form&gt;</code> dont la valeur de l'attribut <code>id</code> correspond à celle indiquée avec l'attribut {{htmlattrxref("form", "input")}} de l'élément <code>&lt;input&gt;</code>).</p>

<p>Pour plus d'informations, voir la documentation de l'attribut {{htmlattrxref("autocomplete", "form")}} pour l'élément {{HTMLElement("form")}}.</p>

<div class="blockIndicator note">
<p><strong>Note :</strong> Afin de fournir des fonctionnalités d'autocomplétion, un agent utilisateur pourra utiliser les prérequis suivants quant aux éléments <code>&lt;input&gt;</code>/<code>&lt;select&gt;</code>/<code>&lt;textarea&gt;</code>:</p>

<ol>
 <li>Que ceux-ci aient un attribut <code>name</code> et/ou <code>id</code></li>
 <li>Que ceux-ci descendent d'un élément <code>&lt;form&gt;</code></li>
 <li>Que le formulaire associé ait un bouton {{HTMLElement("input/submit","submit")}}</li>
</ol>
</div>

<h2 id="Valeurs">Valeurs</h2>

<dl>
 <dt><code>off</code></dt>
 <dd>Le navigateur n'est pas autorisé à saisir automatiquement des valeurs pour ce champ. Cette valeur peut être utilisée lorsque le document ou l'application fournit son propre mécanisme d'autocomplétion ou lorsque des raisons de sécurité imposent de ne pas pouvoir saisir la valeur automatiquement.
 <div class="note"><strong>Note :</strong> Pour la plupart des navigateurs modernes, utiliser <code>autocomplete="off"</code> n'empêchera pas un gestionnaire de mots de passe de demander à l'utilisateur s'il souhaite sauvegarder le nom d'utilisateur et le mot de passe ou de renseigner automatiquement les informations pour un formulaire de connexion. Voir <a href="/fr/docs/Web/Security/Securing_your_site/Turning_off_form_autocompletion#The_autocomplete_attribute_and_login_fields">l'article sur l'attribut <code>autocomplete</code> et les champs des formulaires de connexion</a>.</div>
 </dd>
 <dt><code>on</code></dt>
 <dd>Le navigateur est autorisé à compléter automatiquement le champ. Aucune indication supplémentaire n'est fournie quant au type de donnée attendu et c'est donc au navigateur d'utiliser une heuristique pour proposer des valeurs pertinentes.</dd>
 <dt><code>name</code></dt>
 <dd>Le champ correspondant doit recevoir le nom complet de la personne. Utiliser cette valeur plutôt que les différents composants est une méthode souvent privilégiée car on évite ainsi de gérer les différents structures des différentes locales. Toutefois, on peut utiliser les composants suivants si on souhaite décomposer l'identité de la personne :
 <dl>
  <dt><code>honorific-prefix</code></dt>
  <dd>Le préfixe ou le titre, par exemple « M. », « Mme. », « Me. » , etc.</dd>
  <dt><code>given-name</code></dt>
  <dd>Le prénom.</dd>
  <dt><code>additional-name</code></dt>
  <dd>Le deuxième prénom.</dd>
  <dt><code>family-name</code></dt>
  <dd>Le nom de famille.</dd>
  <dt><code>honorific-suffix</code></dt>
  <dd>Un suffixe (par exemple "Jr.").</dd>
  <dt><code>nickname</code></dt>
  <dd>Un surnom.</dd>
 </dl>
 </dd>
 <dt><code>email</code></dt>
 <dd>Une adresse électronique.</dd>
 <dt><code>username</code></dt>
 <dd>Un nom de compte ou un nom d'utilisateur.</dd>
 <dt><code>new-password</code></dt>
 <dd>Un nouveau mot de passe. Lors de la création d'un compte ou lors d'un changement de mot de passe, cette valeur pourra être utilisée pour le champ où saisir le nouveau mot de passe. Ainsi, on évitera au navigateur de saisir automatiquement le mot de passe actuel ou le navigateur pourra même proposer un outil permettant de créer un mot de passe sécurisé.</dd>
 <dt><code>current-password</code></dt>
 <dd>Le mot de passe actuel de l'utilisateur.</dd>
 <dt><code>one-time-code</code></dt>
 <dd>Un code à usage unique, utilisé pour vérifier l'identité de l'utilisateur.</dd>
 <dt><code>organization-title</code></dt>
 <dd>Un titre de poste tel que « Directeur général », « Assistant technique » ou « Ingénieur ».</dd>
 <dt><code>organization</code></dt>
 <dd>Le nom d'une entreprise ou d'une organisation.</dd>
 <dt><code>street-address</code></dt>
 <dd>Une adresse postale. Cette adresse peut être un texte sur plusieurs lignes et devrait permettre d'identifier complètement l'emplacement de l'adresse au sein d'une ville. Cette valeur n'inclut pas le nom de la ville, le code postal ou le nom du pays.</dd>
 <dt><code>address-line1</code>, <code>address-line2</code>, <code>address-line3</code></dt>
 <dd>Des lignes individuelles pour décrire l'adresse postale. Ces valeurs peuvent être utilisées seulement lorsque la valeur <code>street-address</code> est absente.</dd>
 <dt><code>address-level4</code></dt>
 <dd>Le niveau d'adresse le plus fin (cf. la section ci-après) lorsque les adresses ont quatre niveau.</dd>
 <dt><code>address-level3</code></dt>
 <dd>Le troisième niveau de précision d'une adresse (cf. la section ci-après) lorsque les adresses ont au moins trois niveaux administratifs.</dd>
 <dt><code>address-level2</code></dt>
 <dd>Le deuxième niveau de précision d'une adresse (cf. la section ci-après) lorsque les adresses ont au moins deux niveaux administratifs. Pour les pays avec deux niveaux administratifs, cela correspond généralement à la ville, au village ou à la localité de l'adresse.</dd>
 <dt><code>address-level1</code></dt>
 <dd>Le premier niveau de précision d'une adresse (cf. la section ci-après). C'est généralement la région ou l'état dans lequel se situe l'adresse.</dd>
 <dt><code>country</code></dt>
 <dd>Un code de pays.</dd>
 <dt><code>country-name</code></dt>
 <dd>Un nom de pays.</dd>
 <dt><code>postal-code</code></dt>
 <dd>Un code postal.</dd>
 <dt><code>cc-name</code></dt>
 <dd>Le nom complet tel qu'indiqué sur une carte bancaire. On préfèrera généralement utiliser le nom complet plutôt que de le décomposer en fragments.</dd>
 <dt><code>cc-given-name</code></dt>
 <dd>Le prénom tel qu'indiqué sur une carte bancaire.</dd>
 <dt><code>cc-additional-name</code></dt>
 <dd>Le deuxième prénom tel qu'indiqué sur une carte bancaire.</dd>
 <dt><code>cc-family-name</code></dt>
 <dd>Le nom de famille tel qu'indiqué sur une carte bancaire.</dd>
 <dt><code>cc-number</code></dt>
 <dd>Le numéro de la carte bancaire ou tout autre numéro identifiant une méthode de paiement (ce peut être un numéro de compte par exemple).</dd>
 <dt><code>cc-exp</code></dt>
 <dd>La date d'expiration de la méthode de paiement telle qu'indiquée sur une carte bancaire (généralement sous la forme MM/YY ou sous la forme MM/YYYYY où MM correspond aux deux chiffres du mois et où YY ou YYYY correspondent aux chiffres de l'année).</dd>
 <dt><code>cc-exp-month</code></dt>
 <dd>Le mois d'expiration du moyen de paiement tel qu'indiqué sur une carte bancaire.</dd>
 <dt><code>cc-exp-year</code></dt>
 <dd>L'année d'expiration du moyen de paiement tel qu'indiqué sur une carte bancaire.</dd>
 <dt><code>cc-csc</code></dt>
 <dd>Le cryptogramme du moyen de paiement tel qu'indiqué sur une carte bancaire. il s'agit généralement du code à trois chiffres de vérification situé au dos de la carte bancaire.</dd>
 <dt><code>cc-type</code></dt>
 <dd>Le type de moyen de paiement ("Visa" ou "Master Card").</dd>
 <dt><code>transaction-currency</code></dt>
 <dd>La devise utilisée pour la transaction courante.</dd>
 <dt><code>transaction-amount</code></dt>
 <dd>Le montant de la transaction, pour un formulaire de paiement, exprimé dans la devise fournie par <code>transaction-currency</code>.</dd>
 <dt><code>language</code></dt>
 <dd>La langue préférée, indiquée sous la forme <a href="https://en.wikipedia.org/wiki/IETF_language_tag">d'une balise de langue valide selon BCP 47</a>.</dd>
 <dt><code>bday</code></dt>
 <dd>Une date de naissance complète.</dd>
 <dt><code>bday-day</code></dt>
 <dd>Le jour du mois de la date de naissance.</dd>
 <dt><code>bday-month</code></dt>
 <dd>Le mois de l'année de la date de naissance.</dd>
 <dt><code>bday-year</code></dt>
 <dd>L'année de la date de naissance.</dd>
 <dt><code>sex</code></dt>
 <dd>Un genre (tel que « femme », « homme », « Fa'afafine » etc.) sous la forme d'un texte libre sans passage à la ligne.</dd>
 <dt><code>tel</code></dt>
 <dd>Un numéro de téléphone complet qui inclut l'identifiant du pays. Si le numéro de téléphone doit être décomposé en composants, on pourra utiliser les valeurs suivantes :
 <dl>
  <dt><code>tel-country-code</code></dt>
  <dd>L'indicateur du pays pour le numéro de téléphone (33 pour la France ou 1 pour les États-Unis par exemple).</dd>
  <dt><code>tel-national</code></dt>
  <dd>Le numéro de téléphone complet sans l'indicateur du pays.</dd>
  <dt><code>tel-area-code</code></dt>
  <dd>La code de la zone pour le numéro de téléphone avec un préfixe interne au pays si nécessaire.</dd>
  <dt><code>tel-local</code></dt>
  <dd>Le numéro de téléphone sans l'indicateur de pays ni l'indicateur de zone.</dd>
 </dl>
 </dd>
 <dt><code>tel-extension</code></dt>
 <dd>Une extension au numéro de téléphone qui permet par exemple d'indiquer le numéro de chambre dans un hôtel ou le numéro d'un bureau au sein d'une entreprise.</dd>
 <dt><code>impp</code></dt>
 <dd>Une URL pour un protocole de messagerie instantannée (par exemple "xmpp:username@example.net").</dd>
 <dt><code>url</code></dt>
 <dd>Une URL, pertinente dans le contexte du formulaire.</dd>
 <dt><code>photo</code></dt>
 <dd>L'URL d'une image représentant la personne, l'entreprise ou l'information de contact pour ce formulaire.</dd>
</dl>

<p>Voir <a href="https://html.spec.whatwg.org/multipage/forms.html#autofill">la spécification WHATWG</a> pour plus de détails.</p>

<div class="note">
<p><strong>Note :</strong> À la différence des autres navigateurs, pour Firefox, l'attribut <code>autocomplete</code> contrôlera également si <a href="https://stackoverflow.com/questions/5985839/bug-with-firefox-disabled-attribute-of-input-not-resetting-when-refreshing">l'état de désactivation ou de coche dynamique persiste lors d'un rechargement de la page</a> pour un champ <code>&lt;input&gt;</code>. Par défaut, un élément reste désactivé ou coché/décoché lors des rechargements. En utilisant l'attribut <code>autocomplete</code> avec la valeur <code>off</code>, on désactive cette fonctionnalité. Cela fonctionne, y compris lorsque l'attribut <code>autocomplete</code> ne devrait pas s'appliquer à l'élément <code>&lt;input&gt;</code> d'après son type. Voir {{bug(654072)}}.</p>
</div>

<h2 id="Les_niveaux_administratifs_pour_les_adresses">Les niveaux administratifs pour les adresses</h2>

<p>Les quatre niveaux administratifs pour les adresses (<code>address-level1</code> jusqu'à <code>address-level4</code>) décrivent l'adresse avec un niveau de précision croissant au sein du pays dans lequel l'adresse est situé. Chaque pays possède son propre système de division administrative et peut donc organiser les niveaux selon un ordre différent pour l'écriture des adresses.</p>

<p><code>address-level1</code> représente toujours le niveau le plus large : c'est la composante la moins spécifique de l'adresse après la maille du pays.</p>

<h3 id="Disposition_du_formulaire">Disposition du formulaire</h3>

<p>Étant donné qu'une adresse s'écrit différemment selon le pays, il peut être utile, si possible, de fournir différentes dispositions de formulaires pour les utilisateurs (éventuellement en fonction de leur locale) pour faciliter la saisie de leur adresse pour leur pays.</p>

<h3 id="Variations">Variations</h3>

<p>La façon d'utiliser les niveaux administratifs varie d'un pays à l'autre. Voici quelques exemples non exhaustifs.</p>

<h4 id="États-Unis">États-Unis</h4>

<p>Aux États-Unis, une adresse s'écrit généralement comme suit :</p>

<p>432 Anywhere St<br>
 Exampleville CA 95555</p>

<p>Dans ce cas, la portion la moins précise est le code "CA" (qui correspond au code postal pour l'état de Californie) et on a donc <code>address-level1</code> qui correspond à ce niveau (ici l'état et plus particulièrement : "CA").</p>

<p>La deuxième partie de l'adresse la moins précise est le nom de la ville et c'est donc cette information (ici "Exampleville") qui sera utilisée pour <code>address-level2</code>.</p>

<p>Les niveaux 3 et 4 ne sont pas utilisés aux États-Unis.</p>

<h4 id="Royaume-Uni">Royaume-Uni</h4>

<p>Le Royaume-Uni utilise un ou deux niveaux d'adresse selon l'adresse. Il s'agit de la ville postale et, dans certains cas, de la localité.</p>

<h4 id="Chine">Chine</h4>

<p>La Chine utilise jusqu'à trois niveaux administratifs : la province, la ville et le district.</p>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaires</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('HTML5.2', "sec-forms.html#autofilling-form-controls-the-autocomplete-attribute", "autocomplete")}}</td>
   <td>{{Spec2('HTML5.2')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('HTML WHATWG', "form-control-infrastructure.html#autofilling-form-controls:-the-autocomplete-attribute", "autocomplete")}}</td>
   <td>{{Spec2('HTML WHATWG')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div>

<p>{{Compat("html.global_attributes.autocomplete")}}</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>L'élément HTML {{htmlelement("input")}}</li>
 <li>L'élément HTML {{htmlelement("select")}}</li>
 <li>L'élément HTML {{htmlelement("textarea")}}</li>
 <li>L'élément HTML {{htmlelement("form")}}</li>
 <li><a href="/fr/docs/Web/Guide/HTML/Formulaires">Les formulaires HTML</a></li>
 <li><a href="/fr/docs/Web/HTML/Attributs_universels">Les attributs universels</a>.</li>
</ul>