HTML DOM Document removeEventListener()
Przykład
Usuń zdarzenie „mousemove”, które zostało dołączone za pomocą metody addEventListener():
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Więcej przykładów „Wypróbuj sam” poniżej.
Definicja i użycie
Metoda document.removeEventListener() usuwa procedurę obsługi zdarzeń, która została dołączona za pomocą metody document.addEventListener() .
Uwaga: Aby usunąć moduły obsługi zdarzeń, funkcja określona w metodzie addEventListener() musi być zewnętrzną, „nazwaną” funkcją, jak w powyższym przykładzie (myFunction).
Funkcje anonimowe, takie jak „document.removeEventListener(„ zdarzenie ”, function(){ myScript });” nie będzie działać.
Wskazówka: Użyj metod element .addEventListener() i element .removeEventListener() , aby dodać/usunąć programy obsługi zdarzeń do/z określonego elementu.
Składnia
document.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:
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);
}
Powiązane strony
Samouczek JavaScript: HTML DOM EventListener
Dokumentacja JavaScript: element .removeEventListener()
Obsługa przeglądarki
document.removeEventListener()
to funkcja DOM Level 2 (2001).
Jest w pełni obsługiwany we wszystkich przeglądarkach:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |