Visit Mozilla.org

DOM:element.dispatchEvent

De MDC


Imagen:traduccion-pendiente.png Esta página está traduciéndose a partir del artículo DOM:element.dispatchEvent, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción


« Referencia DOM de Gecko

Tabla de contenidos

[editar] Resumen

Lanza un evento en el sistema de eventos. El evento está sujeto al mismo comportamiento y capacidades que si fuera un evento de lanzamiento directo.

[editar] Sintaxis

bool = element.dispatchEvent(event)
  • element es el objetivo (target en Inglés) del evento.
  • event es un objeto de tipo event que será lanzado.
  • El valor devuelto es false, si al menos uno de los negociadores (en Inglés: handler) que manejan el evento es preventDefault. En caso contrario, devuelve true.

[editar] Ejemplo

Imagen:traduccion-pendiente.png Esta página está traduciéndose a partir del artículo DOM:dispatchEvent_example, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción



Este ejemplo demuestra como simular un clic en una caja de selección, usando métodos del DOM. Puedes ver este ejemplo en acción en: [1].

function simulateClick() {
  var evt = document.createEvent("MouseEvents");
  evt.initMouseEvent("click", true, true, window,
    0, 0, 0, 0, 0, false, false, false, false, 0, null);
  var cb = document.getElementById("checkbox"); 
  var canceled = !cb.dispatchEvent(evt);
  if(canceled) {
    // Un manipulador ha llamado a preventDefault
    alert("cancelado");
  } else {
    // Ningún manipulador ha llamado a preventDefault
    alert("no cancelado");
  }
}





[editar] Notas

Como se ve en el ejemplo anterior, dispatchEvent es el último paso en el proceso crear-inicializar-lanzar, que se usa para el lanzamiento manual de eventos en el modelo de implementación de eventos.

El evento puede ser creado mediante el método document.createEvent e inicializado usando initEvent u otro método, más específicamente, métodos de inicialización como initMouseEvent o initUIEvent.

Ver también Event object reference.

[editar] Especificación

DOM Level 2 Events: dispatchEvent