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

CKTIS / HTML

oncontextmenu — gestionnaire de l’événement de menu contextuel

L’attribut oncontextmenu indique le code JavaScript qui gère l’événement contextmenu. Il est disponible sur tous les éléments HTML ; renvoyer false annule l’événement s’il peut être annulé.

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

Syntaxe

oncontextmenu="JavaScript statements"

oncontextmenu est un attribut global de gestion d’événement HTML, disponible sur chaque élément HTML. Il correspond à l’événement contextmenu, associé à une demande d’affichage du menu contextuel ; l’attribut lui-même ne définit pas de menu.

Sa valeur est le corps d’une fonction JavaScript, et non une URL ni une déclaration de fonction. L’objet événement est accessible sous le nom event. return false annule l’événement s’il peut être annulé ; cela n’arrête pas sa propagation.

Distinguez l’attribut HTML oncontextmenu, la propriété JavaScript element.oncontextmenu et le nom d’événement contextmenu utilisé avec addEventListener(). L’exemple déclenche un événement par programmation afin de vérifier sa gestion et son annulation sans ouvrir manuellement de menu.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncontextmenu example</title>
<button id="target" oncontextmenu="this.textContent = event.type; return false;">Context menu target</button>
<pre id="result"></pre>
<script>
  const target = document.getElementById('target');
  const testEvent = new Event('contextmenu', { cancelable: true });
  target.dispatchEvent(testEvent);
  document.getElementById('result').textContent =
    target.textContent + '\ndefaultPrevented: ' + testEvent.defaultPrevented;
</script>
</html>

Résultat

contextmenu
defaultPrevented: 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.

Sources