HTML DOM removeEventListener() Method

Exemplu

Eliminarea unei "mousemove" eveniment care a fost atașat cu addEventListener() metoda:

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

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

Încearcă - l singur »

Mai multe "Try it Yourself" - "Try it Yourself" exemplele de mai jos.

Definiție și utilizare

document. removeEventListener() document. removeEventListener() metodă elimină o tratare a evenimentului care a fost atașat cu documentul. addEventListener() metoda.

Notă: Pentru a elimina manipulare eveniment, funcția specificată cu addEventListener() metoda trebuie să fie un extern, "named" funcția, ca în exemplul de mai sus (myFunction) .

Funcții anonime, cum ar fi "document. removeEventListener(" event ", function() {myScript});" nu va funcționa.

Sfat: utilizați elementul. addEventListener() și elementul. removeEventListener() metode pentru a adăuga / elimina manipulare eveniment la / de la un element specificat.

Suport pentru browser-

Numerele din tabel specifica prima versiune de browser care acceptă pe deplin metoda.

Metodă
removeEventListener()	1.0	9	1.0	1.0	7

Notă: removeEventListener() metoda nu este acceptată în Internet Explorer 8 și versiunile anterioare, și Opera 6.0 și versiunile anterioare. Cu toate acestea, pentru aceste versiuni specifice de browser, puteți utiliza detachEvent() metoda pentru a elimina manipulare eveniment care au fost atașate cu attachEvent() metoda ( a se vedea "More Examples" de mai jos , pentru o soluție cross-browser).

Sintaxă

document.removeEventListener( event , function , useCapture )

Valorile parametrilor

Parametru	Descriere
event	Necesar. Un șir care specifică numele evenimentului pentru a elimina. Notă: Nu folosiți "on" prefix. De exemplu, utilizați "click" în loc de "onclick" . Sfat: Pentru o listă a tuturor evenimentelor HTML DOM, uita - te la nostru complet HTML DOM Eveniment obiect de referință .
function	Necesar. Specifică funcția de a elimina.
useCapture	Opțional. O valoare Boolean care specifică faza eveniment pentru a elimina de tratare a evenimentelor din. Valori posibile: true - Îndepărtează de tratare a evenimentelor din faza de captare Implicit fals. Îndepărtează de tratare a evenimentelor din faza barbotare Notă: În cazul în care a fost atașat de tratare a evenimentelor de două ori, unul cu capturarea și unul cu barbotare, fiecare trebuie să fie eliminate separat.

Detalii tehnice

DOM Versiune:	DOM Level 2 evenimente
Întoarcere Valoare:	Nici o valoare returnată
Changelog:	Parametrul useCapture a devenit opțional în Firefox 6 și Opera 12.0 (has always been optional for Chrome, IE and Safari)

Mai multe exemple

Exemplu

Pentru browserele care nu acceptă removeEventListener() metoda, puteți utiliza detachEvent() metoda.

Acest exemplu demonstrează o soluție 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);
}

Încearcă - l singur »