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

CKTIS / HTML

onfocus — réagir à la prise de focus

L’attribut onfocus contient du JavaScript exécuté lorsqu’un événement focus est reçu. Il permet de réagir lorsqu’un champ de saisie reçoit le focus, mais ne rend pas à lui seul un élément susceptible de recevoir le focus.

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

Syntaxe

onfocus="JavaScript statements"

onfocus est un attribut de gestion de l’événement focus. Sa valeur correspond au corps d’une fonction JavaScript, et non à un nom d’événement ou à une valeur booléenne. Sur body et frameset, il gère le focus de l’objet Window, et non celui de l’élément lui-même.

Le focus désigne la destination des saisies au clavier. Un champ peut recevoir le focus par la navigation avec Tab ou avec focus(). Ajouter uniquement onfocus ne rend pas un élément susceptible de recevoir le focus. L’événement focus ne remonte pas dans l’arborescence et ne peut pas être annulé ; return false n’empêche pas la prise de focus.

L’attribut HTML et la propriété JavaScript element.onfocus configurent le même gestionnaire. La Content Security Policy peut bloquer le code écrit directement dans l’attribut. N’y insérez pas de texte non fiable en tant que code.

Dans l’exemple, déplacez le focus vers le champ avec Tab. Le texte Waiting devient Focused. Gardez un indicateur de focus visible afin que les personnes utilisant le clavier puissent identifier l’élément actif.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onfocus example</title>
<label for="name">Name</label>
<input id="name" onfocus="document.getElementById('status').textContent = 'Focused';">
<p id="status">Waiting</p>
</html>

Résultat

Focused

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.

Sources