Método HTML DOM removeEventListener()
❮ El Objeto ElementoEjemplo
Elimine un evento "mousemove" que se haya adjuntado con el método addEventListener():
// Attach an event handler to <div>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Remove the event handler from <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
Definición y uso
El método removeEventListener() elimina un controlador de eventos que se ha adjuntado con el método addEventListener() .
Nota: para eliminar los controladores de eventos, la función especificada con el método addEventListener() debe ser una función externa, como en el ejemplo anterior (myFunction).
Funciones anónimas, como " element .removeEventListener(" event ", function(){ myScript });" no trabajará.
Compatibilidad con navegador
Los números en la tabla especifican la primera versión del navegador que soporta totalmente este método.
Method | |||||
---|---|---|---|---|---|
removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Sintaxis
element.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:
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);
}
páginas relacionadas
Tutorial de JavaScript: HTML DOM EventListener
Referencia de JavaScript: document.removeEventListener()
❮ El Objeto Elemento