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

CKTIS / HTML

onmouseover — gérer l’entrée du pointeur

L’attribut onmouseover contient du JavaScript qui gère l’événement mouseover. Il permet de réagir lorsque le pointeur entre sur un élément, mais ne remplace pas la prise en charge du clavier et peut aussi gérer des événements provenant d’éléments descendants.

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

Syntaxe

onmouseover="JavaScript statements"

onmouseover est un attribut HTML global qui gère l’événement mouseover. Sa valeur est le corps d’une fonction JavaScript, et non une URL ou un nom d’événement. Le code s’exécute lorsque l’événement correspondant est déclenché ; ajouter l’attribut ne l’exécute pas à lui seul.

Dans un gestionnaire défini dans un attribut, this désigne l’élément qui gère l’événement, et event fournit l’objet événement. L’attribut contient du code sous forme de texte ; la propriété JavaScript element.onmouseover accepte une fonction ou null.

mouseover remonte dans l’arbre des événements : un gestionnaire placé sur un ancêtre peut donc aussi réagir lorsque le pointeur entre sur un descendant. Le passage d’un descendant à un autre peut provoquer d’autres appels. Ne le confondez pas avec mouseenter, qui ne remonte pas.

Ne faites pas dépendre une fonctionnalité essentielle uniquement du survol. L’exemple ajoute une réaction distincte à onfocus pour l’utilisation au clavier. Une Content Security Policy peut bloquer le code des attributs ; n’y insérez jamais de données non fiables.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onmouseover demo</title>
<button type="button" onmouseover="this.textContent = 'mouseover received'" onfocus="this.textContent = 'focus received'">Try mouse or keyboard</button>
</html>

Résultat

Mouse: mouseover received
Keyboard focus: focus received

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