HTML DOM removeEventListener()Método
Objeto DocumentEjemplo
Eliminar el evento "mousemove" agregado por el método addEventListener():
document.addEventListener("mousemove", myFunction);
// Eliminar el controlador de eventos del documento
document.removeEventListener("mousemove", myFunction);
Pruébalo »
Definición y uso
El método document.removeEventListener() se utiliza para eliminar eldocument.addEventListener()controlador de eventos agregado por el método.
Nota:Si desea eliminar un controlador de eventos, la función ejecutada por addEventListener() debe ser una función externa, como se muestra en el ejemplo anterior (myFunction).
Funciones anónimas, como 'document.removeEventListener('event", function(){ myScript});', ese evento no se puede eliminar.
Consejo:Utilice el element.addEventListener()yelement.removeEventListener()método para agregar o eliminar controladores de eventos de un elemento específico.
Compatibilidad del navegador
Los números de la tabla indican la versión del primer navegador que admite este método.
| Método | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Nota:Internet Explorer 8 y versiones anteriores de IE no admiten el método removeEventListener(), y Opera 7.0 y versiones anteriores de Opera tampoco lo admiten. Sin embargo, para estos navegadores que no admiten esta función, puede utilizardetachEvent()el método para eliminar el controlador de eventos agregado por el método attachEvent() (consulte "Más ejemplos" para ver la solución compatible con varios navegadores).
Sintaxis
Valores de parámetros
| Parámetro | Descripción |
|---|---|
| event | Obligatorio. El nombre del evento que se va a eliminar. Nota:No utilice el prefijo "on". Por ejemplo, use "click" en lugar de "onclick". Consejo:Para todos los eventos HTML DOM, puede consultar nuestro completomanual de referencia del objeto Event de HTML DOM.。 |
| function | Obligatorio. Especifica la función que se va a eliminar. |
| useCapture | Opcional. Valor booleano que especifica la fase en la que se elimina el controlador de eventos. Valores posibles:
|
Detalles técnicos
| Versión DOM: | DOM Level 2 events |
|---|---|
| Valor de retorno: | Sin valor de retorno |
| Registro de modificaciones: | En Firefox 6 y Opera 12.0, el parámetro useCapture es opcional. (En Chrome, IE y Safari siempre ha sido opcional). |
Más ejemplos
Ejemplo
Si el navegador no admite el método removeEventListener(), puede utilizar el método detachEvent().
Este ejemplo demuestra una solución compatible con varios navegadores:
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // IE 8 y versiones anteriores
document.detachEvent("onmousemove", myFunction);
}
Pruébalo »
Artículos relacionados
Tutorial de JavaScript:HTML DOM EventListener
Referencia de JavaScript:element.removeEventListener()
Otras extensiones