CKTIS / HTML
oncontextmenu — processador do evento do menu de contexto
O atributo oncontextmenu especifica o código JavaScript que processa o evento contextmenu. Está disponível em todos os elementos HTML; devolver false cancela o evento se este for cancelável.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
oncontextmenu="JavaScript statements"oncontextmenu é um atributo global de processamento de eventos HTML, disponível em todos os elementos HTML. Corresponde ao evento contextmenu, associado a um pedido de menu de contexto; o próprio atributo não define um menu.
O seu valor é o corpo de uma função JavaScript, não um URL nem uma declaração de função. O objeto do evento está disponível como event. return false cancela o evento se este for cancelável; não impede a sua propagação.
Distingue o atributo HTML oncontextmenu, a propriedade JavaScript element.oncontextmenu e o nome do evento contextmenu usado com addEventListener(). O exemplo envia um evento por programação para verificar o seu processamento e cancelamento sem abrir manualmente um menu.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.