Ejemplo
Retirar un "mousemove" evento que se ha unido con el addEventListener() método:
// Attach an event handler to the document
document.addEventListener("mousemove",
myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Inténtalo tú mismo " Más "Try it Yourself" ejemplos a continuación.
Definición y Uso
El document. removeEventListener() document. removeEventListener() método elimina un controlador de eventos que se ha unido con el documento. addEventListener() método.
Nota: Para eliminar los controladores de eventos, la función especificada con el addEventListener() método debe ser un externo, "named" función, como en el ejemplo anterior (myFunction) .
Las funciones anónimas, como "documento. removeEventListener(" event ", function() {} myScript);" no trabajará.
Consejo: Utilice el elemento. addEventListener() y elemento. removeEventListener() métodos para añadir / quitar controladores de eventos a / de un elemento especificado.
Soporte del navegador
Los números de la tabla especifican la primera versión del navegador que es totalmente compatible con el método.
Método | |||||
---|---|---|---|---|---|
removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Nota: El removeEventListener() método no es compatible en Internet Explorer 8 y versiones anteriores, y Opera 6.0 y versiones anteriores. Sin embargo, para estas versiones específicas del navegador, puede utilizar la detachEvent() método para eliminar controladores de eventos que se han adjuntado con el attachEvent() método (ver "More Examples" a continuación para obtener una solución multi-navegador).
Sintaxis
document.removeEventListener( event , function ,
useCapture )
Los valores de los parámetros
Parámetro | Descripción |
---|---|
event | Necesario. Una cadena que especifica el nombre del evento de eliminar. Nota: No utilice el "on" prefijo. Por ejemplo, utilice "click" en lugar de "onclick" . Consejo: Para obtener una lista de todos los eventos DOM HTML, visita nuestra completa HTML DOM evento de referencia del objeto . |
function | Necesario. Especifica la función de eliminar. |
useCapture | Opcional. Un valor booleano que especifica la fase del evento para eliminar el controlador de eventos de. Valores posibles:
|
Detalles técnicos
DOM Versión: | DOM nivel 2 eventos |
---|---|
Valor de retorno: | Sin valor de retorno |
cambios: | El parámetro useCapture se hizo opcional en Firefox 6 y Opera 12.0 (has always been optional for Chrome, IE and Safari) |
Más ejemplos
Ejemplo
Para los navegadores que no soporten el removeEventListener() método, se puede utilizar el detachEvent() método.
Este ejemplo demuestra una solución multi-navegador:
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);
}
Inténtalo tú mismo " Páginas relacionadas
JavaScript Tutorial: HTML DOM EventListener
JavaScript Referencia: elemento. removeEventListener()