Documento HTML DOM removeEventListener()
Exemplo
Remova um evento "mousemove" que foi anexado com o método addEventListener():
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Mais exemplos de "Experimente você mesmo" abaixo.
Definição e uso
O método document.removeEventListener() remove um manipulador de eventos que foi anexado com o método document.addEventListener() .
Nota: Para remover manipuladores de eventos, a função especificada com o método addEventListener() deve ser uma função externa "nomeada", como no exemplo acima (myFunction).
Funções anônimas, como "document.removeEventListener(" event ", function(){ myScript });" não funciona.
Dica: Use os métodos element .addEventListener() e element .removeEventListener() para adicionar/remover manipuladores de eventos de/para um elemento especificado.
Sintaxe
document.removeEventListener(event, function, useCapture)
Valores de parâmetro
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:
|
Detalhes técnicos
Versão DOM: | Eventos DOM Nível 2 |
---|---|
Valor de retorno: | Sem valor de retorno |
Registro de alterações: | O parâmetro useCapture tornou-se opcional no Firefox 6 e Opera 12.0 (sempre foi opcional para Chrome, IE e Safari) |
Mais exemplos
Exemplo
Para navegadores que não suportam o método removeEventListener(), você pode usar o método detachEvent().
Este exemplo demonstra uma solução entre navegadores:
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);
}
Páginas relacionadas
Tutorial JavaScript: HTML DOM EventListener
Referência JavaScript: elemento .removeEventListener()
Suporte ao navegador
document.removeEventListener()
é um recurso DOM Nível 2 (2001).
É totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |