Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

terme ou valeur HTML: autofocus

L’attribut `autofocus` demande au navigateur de focaliser un élément quand il devient disponible dans le document, un dialogue ou un popover ; ce n’est ni une garantie ni une commande de défilement.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<input name="query" autofocus>

autofocus est un attribut booléen : sa présence compte, donc autofocus="false" l’active encore. Un candidat doit satisfaire les étapes de focalisation et appartenir à la portée de focus concernée.

Pour un dialogue, la demande est traitée lors de son ouverture par showModal(). Une portée de focus ne peut déclarer qu’un candidat ; document.activeElement le désigne après la réussite des étapes de focalisation.

Le focus automatique peut déplacer l’utilisateur sans avertissement, modifier la position de lecture d’un lecteur d’écran et ouvrir un clavier virtuel. Réservez-le à une action suivante évidente, avec titre et consignes déjà disponibles.

L’exemple place autofocus sur le premier champ seulement : sa propriété vaut true, celle du second false et document.activeElement porte l’identifiant first. Il s’agit d’un candidat unique conforme.

Exemples

<!doctype html><meta charset="utf-8"><dialog id="d"><input id="first" autofocus><input id="second"></dialog><output id="result"></output><script>d.showModal();result.textContent=`first=${first.autofocus}; second=${second.autofocus}; active=${document.activeElement.id}`;</script>

Résultat

first=true; second=false; active=first

L’exemple exécuté vérifie le focus de l’unique candidat déclaré à l’ouverture du dialogue modal.

Sources