HTML DOM dokument removeEventListener()
Příklad
Odeberte událost "mousemove", která byla připojena 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);
Další příklady „Vyzkoušejte si to sami“ níže.
Definice a použití
Metoda document.removeEventListener() odebere obsluhu události, která byla připojena pomocí metody document.addEventListener() .
Poznámka: Chcete-li odstranit obslužné rutiny událostí, funkce zadaná pomocí metody addEventListener() musí být externí, "pojmenovaná" funkce, jako ve výše uvedeném příkladu (myFunction).
Anonymní funkce, jako "document.removeEventListener(" event ", function(){ myScript });" to nebude fungovat.
Tip: Použijte metody element .addEventListener() a element .removeEventListener() k přidání/odebírání obslužných rutin událostí do/z určeného elementu.
Syntax
document.removeEventListener(event, function, useCapture)
Hodnoty parametrů
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:
|
Technické údaje
Verze DOM: | Události DOM úrovně 2 |
---|---|
Návratová hodnota: | Žádná návratová hodnota |
Seznam změn: | Parametr useCapture se stal volitelným ve Firefoxu 6 a Opeře 12.0 (vždy byl volitelný pro Chrome, IE a Safari) |
Další příklady
Příklad
Pro prohlížeče, které nepodporují metodu removeEventListener(), můžete použít metodu removeEvent().
Tento příklad ukazuje řešení pro různé prohlížeče:
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);
}
Související stránky
Výukový program JavaScript: HTML DOM EventListener
Reference JavaScript: element .removeEventListener()
Podpora prohlížeče
document.removeEventListener()
je funkce DOM úrovně 2 (2001).
Je plně podporován ve všech prohlížečích:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |