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.