EventTarget.removeEventListener()
Remove o event listener anteriormente registrado comEventTarget.addEventListener()
.
Sintaxe
target.removeEventListener(type, listener[, useCapture])
type
-
Uma string indicando o tipo de evento a ser removido.
listener
-
A função
EventListener
a ser removida do event target. useCapture
Optional-
Indica quando o
EventListener
a ser removido foi registrado ou não comocapturing listener.Caso este parâmetro seja omitido, o valorfalseserá assumido por padrão.Se um listener foi registrado duas vezes, uma com o parâmetrocaptureespecificado e outra sem, cada um deve ser removido separadamente. A remoção de umcapturing listenernão afeta a versãonon-capturingdo mesmo listener, e vice versa.
Nota:useCapture
era obrigatório em versões mais antigas dos navegadores. Para ampla compatibilidade, sempre informe o parâmetrouseCapture.
Notas
Se umEventListener
é removido de umEventTarget
enquantoesteestá processando um evento, esse não será disparado pelascurrent actions.UmEventListener
não será invocado para o evento o qual foi registrado depois de ter sido removido, porém pode ser registrado novamente.
ChamarremoveEventListener()
com argumentos que não identifiquem nenhumEventListener
registrado noEventTarget
não tem qualquer efeito.
Exemplo
Este é um exemplo de como associar e remover um event listener.
vardiv=document.getElementById("div");
varlistener=function(event){
/* faça alguma coisa... */
};
div.addEventListener("click",listener,false);
div.removeEventListener("click",listener,false);
Especificações
Specification |
---|
DOM Standard #ref-for-dom-eventtarget-removeeventlistener② |
Compatibilidade com navegadores
BCD tables only load in the browser