English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

HTML DOM removeEventListener() 方法

Objeto Documento de HTML DOM

document.removeEventListener()删除附加在document.addEventListener()方法中的事件处理程序。

Nota:要删除事件处理程序,用addEventListener()方法指定的函数必须是外部的“命名"函数,如下面的示例(myFunc)。

匿名函数,例如"document.removeEventListener("event",function(){ statement });" 不管用。

使用元素 .addEventListener()方法将事件处理程序附加到指定的元素。

使用元素 .removeEventListener()方法从指定的元素中删除事件处理程序。

语法:

document.removeEventListener(event, listener, useCapture)
// 将事件处理程序附加到文档
document.addEventListener("mousemove", myFunc);
// 从文档中删除事件处理程序
document.removeEventListener("mousemove", myFunc);
测试看看‹/›

浏览器兼容性

表中的数字指定了完全支持removeEventListener()方法的第一个浏览器版本:

方法
removeEventListener()1171.09

参数值

参数描述
event(必需)要删除的JavaScript事件的名称。使用事件时不使用"on"前缀,例如使用"click"代替"onclick"或"mousedown"代替"onmousedown"。
有关所有HTML DOM事件的列表,请参考我们完整的Referencia de objeto de eventos de HTML DOM.
listener(requerido)Nombre de la función de JavaScript que se va a eliminar.
useCapture(opcional)Booleano que especifica si se elimina en la fase de captura o en la fase de burbuja. El valor predeterminado es falso.
Valores posibles:
  • verdadero-Se eliminó el gestor de eventos en la fase de captura

  • falso-Se eliminó el gestor de eventos en la fase de burbuja

Nota:Si el gestor de eventos se ha adjuntado dos veces, una vez en la fase de captura y otra en la fase de burbuja, debe eliminarse por separado.
Puede encontrar en nuestroen el tutorial de propagación de eventos de JavaScriptLeer sobrePropagación de eventospara obtener más información

Detalles técnicos

Valor de retorno:Ninguno
Versión de DOM:DOM 2Nivel

Referencias relacionadas

Tutoriales de JavaScript:Escuchadores de eventos

Tutoriales de JavaScript:Propagación de eventos

Referencia de HTML DOM:document.addEventListener()

Referencia de HTML DOM:elemento.removeEventListener()

Objeto Documento de HTML DOM