tutoriais mais recente desenvolvimento web
 

HTML DOM removeEventListener() Method

<Elemento de objeto

Exemplo

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

// Attach an event handler to <div>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);

// Remove the event handler from <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
Tente você mesmo "

Definição e Uso

O removeEventListener() método remove um processador de eventos que tem sido ligado com a addEventListener() método.

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

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


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

Sintaxe

element .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)

Exemplos

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:

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);
}
Tente você mesmo "

Páginas relacionadas

JavaScript Tutorial: HTML DOM EventListener

JavaScript Referência: documento. removeEventListener()


<Elemento de objeto