Documento HTML DOM removeEventListener()
Ejemplo
Elimine un evento "mousemove" que se haya adjuntado con el método addEventListener():
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Más ejemplos de "Pruébelo usted mismo" a continuación.
Definición y uso
El método document.removeEventListener() elimina un controlador de eventos que se ha adjuntado con el método document.addEventListener() .
Nota: Para eliminar los controladores de eventos, la función especificada con el método addEventListener() debe ser una función externa con "nombre", como en el ejemplo anterior (myFunction).
Funciones anónimas, como "document.removeEventListener(" event ", function(){ myScript });" no trabajará.
Sugerencia: use los métodos element .addEventListener() y element .removeEventListener() para agregar o eliminar controladores de eventos de un elemento específico.
Sintaxis
document.removeEventListener(event, function, useCapture)
Valores paramétricos
Parameter | Description |
---|---|
event | Required. A String that specifies the name of the event to remove. Note: Do not use the "on" prefix. For example, use "click" instead of "onclick". Tip: For a list of all HTML DOM events, look at our complete HTML DOM Event Object Reference. |
function | Required. Specifies the function to remove. |
useCapture |
Optional. A Boolean value that specifies the event phase
to remove the event handler from. Possible values:
|
Detalles técnicos
Versión DOM: | Eventos DOM Nivel 2 |
---|---|
Valor devuelto: | Sin valor de retorno |
Registro de cambios: | El parámetro useCapture se volvió opcional en Firefox 6 y Opera 12.0 (siempre ha sido opcional para Chrome, IE y Safari) |
Más ejemplos
Ejemplo
Para los navegadores que no admiten el método removeEventListener(), puede usar el método detachEvent().
Este ejemplo demuestra una solución de navegador cruzado:
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);
}
páginas relacionadas
Tutorial de JavaScript: HTML DOM EventListener
Referencia de JavaScript: elemento .removeEventListener()
Compatibilidad con navegador
document.removeEventListener()
es una característica DOM Nivel 2 (2001).
Es totalmente compatible con todos los navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |