CKTIS / JavaScript
HTMLElement.focus — définir le focus par programmation
La méthode focus() déplace le focus vers un élément qui peut le recevoir. Découvrez en quoi le focus diffère d’un clic, comment fonctionnent les options de défilement et d’indication du focus, et comment vérifier le résultat.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.focus();
element.focus({ preventScroll: true });
element.focus({ preventScroll: true, focusVisible: true });HTMLElement.focus place le focus sur un élément s’il peut le recevoir ; cette méthode ne déclenche pas de clic. Elle renvoie undefined, et non un indicateur de réussite. Dans un document simple, vérifiez le résultat avec document.activeElement === element.
L’élément doit pouvoir recevoir le focus. tabindex="-1" permet de placer programmatiquement le focus sur un élément ordinaire sans l’ajouter à la navigation séquentielle avec la touche Tab. focus() ne contourne pas les restrictions concernant les éléments désactivés, ceux rendus inactifs par inert ou ceux qui ne sont pas rendus à cause de display: none.
Par défaut, la méthode fait défiler la page jusqu’à rendre l’élément visible ; preventScroll: true empêche ce défilement. Le navigateur décide généralement s’il affiche un indicateur de focus. focusVisible: true demande son affichage. Ne supprimez pas l’indicateur visible sans proposer d’alternative.
Il s’agit d’une API du standard HTML, et non d’ECMAScript. La méthode de base focus() est prise en charge par les moteurs de navigateur actuels ; vérifiez séparément la prise en charge des options dans les navigateurs visés. Node 24 ne permet pas d’établir la prise en charge de l’API du navigateur. L’exemple appelle délibérément la méthode à la suite d’une action de l’utilisateur.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Focus example</title>
<button id="move" type="button">Focus target</button>
<p id="target" tabindex="-1">Target</p>
<pre id="result"></pre>
<script>
const move = document.getElementById('move');
const target = document.getElementById('target');
const result = document.getElementById('result');
move.addEventListener('click', () => {
target.focus({ preventScroll: true });
result.textContent = String(document.activeElement === target);
});
</script>
</html>Résultat
true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.