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
Exemple
#<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>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
#<element autofocus>…</element>Plus d’exemples
#<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êmefocus()lorsque l’élément apparaît sur la page.
Entrées associées
#- <input>Un champ de formulaire : texte, e-mail, mot de passe, nombre, date, curseur, case à cocher, fichier et bien plus encore.
- <dialog>Une boîte de dialogue ou fenêtre modale : confirmation, formulaire ou message affiché au-dessus du reste de la page.
- popoverTransforme un élément en fenêtre contextuelle ouverte par un bouton, sans JavaScript.
- tabindexDétermine si un élément peut recevoir le focus avec la touche Tab et dans quel ordre.
- accesskeyUn raccourci clavier qui place le focus sur l’élément ou l’active immédiatement.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.