CKTIS / HTML
oncontextmenu — controlador del evento de menú contextual
El atributo oncontextmenu especifica el código JavaScript que gestiona el evento contextmenu. Está disponible en todos los elementos HTML; devolver false cancela el evento si se puede cancelar.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
oncontextmenu="JavaScript statements"oncontextmenu es un atributo global de gestión de eventos HTML disponible en todos los elementos HTML. Corresponde al evento contextmenu, asociado a una solicitud del menú contextual; el atributo en sí no define ningún menú.
Su valor es el cuerpo de una función JavaScript, no una URL ni una declaración de función. El objeto del evento está disponible como event. return false cancela el evento si se puede cancelar; no detiene su propagación.
Distingue el atributo HTML oncontextmenu, la propiedad JavaScript element.oncontextmenu y el nombre de evento contextmenu que se usa con addEventListener(). El ejemplo envía un evento mediante programación para comprobar su gestión y cancelación sin abrir un menú manualmente.
Ejemplos
<!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>Resultado
contextmenu defaultPrevented: true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.