HTML DOM removeEventListener() Method

Esempio

Rimuovere un "mousemove" evento che è stato attaccato con addEventListener() Metodo:

// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);

// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);

Prova tu stesso "

Più "Try it Yourself" esempi di seguito.

Definizione e l'utilizzo

Il document. removeEventListener() document. removeEventListener() metodo rimuove un gestore di eventi che è stato allegato con il documento. addEventListener() metodo.

Nota: Per rimuovere i gestori di eventi, la funzione specificata con l' addEventListener() metodo deve essere esterna, "named" funzione, come nell'esempio precedente (myFunction) .

Funzioni anonime, come "documento. removeEventListener(" event ", function() {} myScript);" non funzionerà.

Suggerimento: Utilizzare l'elemento. addEventListener() ed elemento. removeEventListener() metodi per aggiungere / rimuovere gestori di eventi a / da un elemento specificato.

Supporto browser

I numeri nella tabella indicano la prima versione del browser che supporta pienamente il metodo.

Metodo
removeEventListener()	1.0	9.0	1.0	1.0	7.0

Nota: Il removeEventListener() metodo non è supportato in Internet Explorer 8 e versioni precedenti, e Opera 6.0 e versioni precedenti. Tuttavia, per queste versioni specifiche del browser, è possibile utilizzare la detachEvent() metodo per rimuovere i gestori di eventi che sono stati allegati con l' attachEvent() il metodo (vedi "More Examples" al di sotto di una soluzione cross-browser).

Sintassi

document.removeEventListener( event , function , useCapture )

valori dei parametri

Parametro	Descrizione
event	Necessario. Una stringa che specifica il nome dell'evento da rimuovere. Nota: Non utilizzare il "on" prefisso. Ad esempio, utilizzare "click" al posto di "onclick" . Suggerimento: per un elenco di tutti gli eventi HTML DOM, guarda la nostra completa HTML DOM oggetto evento di riferimento .
function	Necessario. Specifica la funzione per rimuovere.
useCapture	Opzionale. Un valore booleano che specifica la fase di evento per rimuovere il gestore di eventi da. Valori possibili: vero - Rimuove il gestore di eventi dalla fase di cattura Predefinito di falsi. Rimuove il gestore di eventi dalla fase di bubbling Nota: se il gestore di eventi è stato attaccato due volte, una con la cattura e uno spumeggiante, ognuno deve essere rimossa separatamente.

Dettagli tecnici

DOM Versione:	Livello 2 eventi DOM
Valore di ritorno:	Nessun valore di ritorno
changelog:	Il parametro useCapture è diventato opzionale in Firefox 6 e Opera 12.0 (has always been optional for Chrome, IE and Safari)

Altri esempi

Esempio

Per i browser che non supportano il removeEventListener() metodo, è possibile utilizzare la detachEvent() metodo.

Questo esempio dimostra 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);
}

Prova tu stesso "