Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

oncontextmenu — gestore dell’evento del menu contestuale

L’attributo oncontextmenu specifica il codice JavaScript che gestisce l’evento contextmenu. È disponibile su tutti gli elementi HTML; restituire false annulla l’evento se è annullabile.

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

Sintassi

oncontextmenu="JavaScript statements"

oncontextmenu è un attributo globale HTML per la gestione degli eventi, disponibile su ogni elemento HTML. Corrisponde all’evento contextmenu, associato alla richiesta di un menu contestuale; l’attributo in sé non definisce un menu.

Il suo valore è il corpo di una funzione JavaScript, non un URL né una dichiarazione di funzione. L’oggetto evento è disponibile come event. return false annulla l’evento se è annullabile; non ne interrompe la propagazione.

Distingui l’attributo HTML oncontextmenu, la proprietà JavaScript element.oncontextmenu e il nome dell’evento contextmenu usato con addEventListener(). L’esempio invia un evento tramite codice per verificarne la gestione e l’annullamento senza aprire manualmente un menu.

Esempi

<!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>

Risultato

contextmenu
defaultPrevented: true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti