HTML DOM removeEventListener() Method

Exemplo

Retirar um "mousemove" evento que foi anexado com o addEventListener() método:

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

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

Tente você mesmo "

Mais "Try it Yourself" exemplos abaixo.

Definição e Uso

O document. removeEventListener() document. removeEventListener() método remove um processador de eventos que foi ligado com o documento. addEventListener() método.

Nota: Para remover manipuladores de eventos, a função especificada com o addEventListener() método deve ser um link externo, "named" função, como no exemplo acima (myFunction) .

Funções anônimas, como "documento. removeEventListener(" event ", function() {oMeuPrograma});" não funciona.

Dica: Use o elemento. addEventListener() e elemento. removeEventListener() métodos para adicionar / remover tratadores de eventos para / a partir de um elemento especificado.

Suporte navegador

Os números na tabela especificar a primeira versão do navegador que suporta totalmente o método.

Método
removeEventListener()	1.0	9	1.0	1.0	7

Nota: O removeEventListener() método não é suportado no Internet Explorer 8 e versões anteriores, e Opera 6.0 e versões anteriores. No entanto, para estas versões específicas do navegador, você pode usar o detachEvent() método para remover manipuladores de eventos que foram anexados com o attachEvent() método (ver "More Examples" a seguir para obter uma solução cross-browser).

Sintaxe

document.removeEventListener( event , function , useCapture )

Os valores dos parâmetros

Parâmetro	Descrição
event	Requeridos. Um String que especifica o nome do evento para remover. Nota: Não use o "on" prefixo. Por exemplo, use "click" em vez de "onclick" . Dica: Para obter uma lista de todos os eventos HTML DOM, vá para a completa HTML DOM Evento Object Reference .
function	Requeridos. Especifica a função de remover.
useCapture	Opcional. Um valor booleano que especifica a fase de evento para remover o manipulador de eventos. Valores possíveis: verdade - Remove o manipulador de eventos desde a fase de captura Padrão falso-. Remove o manipulador de eventos a partir da fase de bolha Nota: Se o manipulador de eventos foi anexado duas vezes, uma com a captura e uma borbulhante, cada um deve ser removido separadamente.

Detalhes técnicos

DOM Versão:	DOM Nível 2 eventos
Valor de retorno:	Nenhum valor de retorno
changelog:	O parâmetro useCapture tornou opcional no Firefox 6 e Opera 12.0 (has always been optional for Chrome, IE and Safari)

mais Exemplos

Exemplo

Para navegadores que não suportam o removeEventListener() método, você pode usar o detachEvent() método.

Este exemplo demonstra uma solução 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);
}

Tente você mesmo "