Metodo HTML DOM removeEventListener()
❮ L'oggetto elementoEsempio
Rimuovere un evento "mousemove" che è stato allegato con il metodo addEventListener():
// Attach an event handler to <div>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Remove the event handler from <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
Definizione e utilizzo
Il metodo removeEventListener() rimuove un gestore di eventi che è stato collegato con il metodo addEventListener() .
Nota: per rimuovere i gestori di eventi, la funzione specificata con il metodo addEventListener() deve essere una funzione esterna, come nell'esempio precedente (myFunction).
Funzioni anonime, come " element .removeEventListener(" event ", function(){ myScript });" non funzionerà.
Supporto browser
I numeri nella tabella specificano la prima versione del browser che supporta completamente il metodo.
| Method | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Sintassi
element.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:
var x = document.getElementById("myDIV");
if (x.removeEventListener) { // For all major browsers, except IE 8 and earlier
x.removeEventListener("mousemove", myFunction);
} else if (x.detachEvent) { // For IE 8 and earlier versions
x.detachEvent("onmousemove", myFunction);
}
Pagine correlate
Esercitazione JavaScript: EventListener HTML DOM
Riferimento JavaScript: document.removeEventListener()
❮ L'oggetto elemento