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.