Attribut global HTMLAttributs globaux

autofocus

Place le focus sur l’élément dès le chargement de la page ou l’ouverture de la boîte de dialogue.

S’applique à
Éléments pouvant recevoir le focus : champs de formulaire, boutons, liens et éléments avec tabindex
Sur cette page

Exemple

#
HTML
<form>
  <label for="q">Que voulez-vous apprendre aujourd’hui ?</label>
  <input type="search" id="q" name="q" placeholder="p. ex. flexbox, boucles, tableaux" autofocus>
  <button>Rechercher</button>
</form>
Aperçu

Dans l’aperçu, autofocus est volontairement désactivé pour que l’exemple ne vole pas le focus à la page de documentation. Sur une page ordinaire, le curseur clignoterait aussitôt dans le champ de recherche.

Définition et utilisation

#

L’attribut booléen autofocus désigne l’élément qui doit recevoir le focus sans clic. Sur une page ordinaire, cela se produit juste après son chargement, et dans un <dialog> et une fenêtre avec l’attribut popover au moment de leur ouverture. L’utilisateur peut alors écrire tout de suite ou appuyer sur Entrée.

Il convient là où un seul champ est le but principal de la visite : une page de moteur de recherche, une connexion, une fenêtre avec une question. Au plus un élément de la page devrait l’avoir. Si plusieurs l’ont, le focus va au premier d’entre eux.

Le focus automatique a un coût. Le navigateur fait défiler la page jusqu’à l’élément, si bien qu’un utilisateur de lecteur d’écran peut manquer tout ce qui se trouve au-dessus, et sur téléphone le focus dans un champ de texte peut aussitôt faire surgir le clavier et masquer la moitié de l’écran. Les navigateurs ignorent aussi autofocus dans les cadres intégrés depuis un autre domaine et lorsque l’utilisateur a déjà déplacé le focus ailleurs.

Syntaxe

#
Syntaxe
<element autofocus>…</element>

Plus d’exemples

#
Un bouton sûr dans une boîte de dialogue avec une question
HTML
<dialog id="remove-dialog">
  <p>Retirer la formation « Python à partir de zéro » des favoris ?</p>
  <form method="dialog">
    <button value="remove">Retirer</button>
    <button value="cancel" autofocus>Annuler</button>
  </form>
</dialog>

<button type="button" onclick="document.getElementById('remove-dialog').showModal()">
  Retirer des favoris
</button>

À l’ouverture de la boîte de dialogue, le focus va sur le bouton « Annuler » : un appui accidentel sur Entrée ne supprimera donc rien.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ne donnez pas autofocus à un champ au milieu d’une longue page. L’utilisateur arrivera d’emblée au milieu du contenu sans savoir ce qu’il a sauté.
  • Lorsque le focus doit se déplacer après une action de l’utilisateur, par exemple après un clic sur « Modifier », appelez element.focus() dans un script.
  • Dans React, vous écrivez l’attribut autoFocus. React appelle alors lui-même focus() lorsque l’élément apparaît sur la page.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.