Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes