Documento HTML DOM removeEventListener()
Esempio
Rimuovere un evento "mousemove" che è stato allegato con il metodo addEventListener():
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Altri esempi "Provalo da solo" di seguito.
Definizione e utilizzo
Il metodo document.removeEventListener() rimuove un gestore di eventi che è stato allegato con il metodo document.addEventListener() .
Nota: per rimuovere i gestori di eventi, la funzione specificata con il metodo addEventListener() deve essere una funzione "denominata" esterna, come nell'esempio precedente (myFunction).
Funzioni anonime, come "document.removeEventListener(" event ", function(){ myScript });" non funzionerà.
Suggerimento: utilizzare i metodi element .addEventListener() e element .removeEventListener() per aggiungere/rimuovere gestori di eventi a/da un elemento specificato.
Sintassi
document.removeEventListener(event, function, useCapture)
Valori dei parametri
Parameter | Description |
---|---|
event | Required. A String that specifies the name of the event to remove. Note: Do not use the "on" prefix. For example, use "click" instead of "onclick". Tip: For a list of all HTML DOM events, look at our complete HTML DOM Event Object Reference. |
function | Required. Specifies the function to remove. |
useCapture |
Optional. A Boolean value that specifies the event phase
to remove the event handler from. Possible values:
|
Dettagli tecnici
Versione DOM: | Eventi DOM di livello 2 |
---|---|
Valore di ritorno: | Nessun valore di ritorno |
Registro delle modifiche: | Il parametro useCapture è diventato opzionale in Firefox 6 e Opera 12.0 (è sempre stato opzionale per Chrome, IE e Safari) |
Altri esempi
Esempio
Per i browser che non supportano il metodo removeEventListener(), puoi utilizzare il metodo detachEvent().
Questo esempio mostra una soluzione cross-browser:
if (document.removeEventListener) { // For all major browsers, except IE 8 and earlier
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // For IE 8 and earlier versions
document.detachEvent("onmousemove", myFunction);
}
Pagine correlate
Esercitazione JavaScript: EventListener HTML DOM
Riferimento JavaScript: elemento .removeEventListener()
Supporto browser
document.removeEventListener()
è una funzionalità DOM di livello 2 (2001).
È completamente supportato in tutti i browser:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |