Metoda HTML DOM removeEventListener()
❮ Obiekt elementuPrzykład
Usuń zdarzenie „mousemove”, które zostało dołączone za pomocą metody 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);
Definicja i użycie
Metoda removeEventListener() usuwa procedurę obsługi zdarzeń, która została dołączona za pomocą metody addEventListener() .
Uwaga: Aby usunąć moduły obsługi zdarzeń, funkcja określona w metodzie addEventListener() musi być funkcją zewnętrzną, jak w powyższym przykładzie (myFunction).
Funkcje anonimowe, takie jak " element .removeEventListener(" zdarzenie ", function(){ myScript });" nie będzie działać.
Obsługa przeglądarki
Liczby w tabeli określają pierwszą wersję przeglądarki, która w pełni obsługuje tę metodę.
Method | |||||
---|---|---|---|---|---|
removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Składnia
element.removeEventListener(event, function, useCapture)
Wartości parametrów
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:
|
Szczegóły techniczne
Wersja DOM: | Wydarzenia DOM Level 2 |
---|---|
Wartość zwrotu: | Brak wartości zwrotu |
Dziennik zmian: | Parametr useCapture stał się opcjonalny w Firefoksie 6 i Operze 12.0 (zawsze był opcjonalny w Chrome, IE i Safari) |
Więcej przykładów
Przykład
W przypadku przeglądarek, które nie obsługują metody removeEventListener(), można użyć metody detachEvent().
Ten przykład ilustruje rozwiązanie dla różnych przeglądarek:
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);
}
Powiązane strony
Samouczek JavaScript: HTML DOM EventListener
Dokumentacja JavaScript: document.removeEventListener()
❮ Obiekt elementu