DOM:document.createEvent

De MDC

« Referencia DOM de Gecko

Tabla de contenidos 1 Resumen 2 Sintaxis 3 Ejemplo 4 Notas 5 Especificaciones

[editar] Resumen

Crea un event del tipo especificado. El objeto devuelto debe antes ser inicializado y puede, posteriormente, ser pasado a element.dispatchEvent.

[editar] Sintaxis

event = document.createEvent(type)

• event es el objeto Event creado.
• type es una cadena que representa el tipo de evento que se creará. Los tipos de evento posibles incluyes "UIEvents", "MouseEvents", "MutationEvents", y "HTMLEvents". Vea la sección Notas para más detalles.

[editar] Ejemplo

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

Las cadenas de tipo que pueden pasarse a createEvent están definidas en event modules. Algunos módulos de eventos están definidas en las especificaciones DOM Events, algunos módulos están definidos en otras especificaciones (como SVG) y algunos tipos de eventos son específicos de Gecko. Ver la tabla más abajo para más detalles.

To-do: add event names to the table too.

Event Module	Tipo de evento para pasar a createEvent	Método a usar para inicializar el evento
DOM Level 2 Events
User Interface event module	"UIEvents"	event.initUIEvent
Mouse event module	"MouseEvents"	event.initMouseEvent
Mutation event module	"MutationEvents"	event.initMutationEvent
HTML event module	"HTMLEvents"	event.initEvent
DOM Level 3 Events
Eventos de interfaz de usuario	"UIEvent", "UIEvents"	event.initUIEvent
eventos de ratón	"MouseEvent", "MouseEvents"	event.initMouseEvent
Mutation event module	"MutationEvent", "MutationEvents"	event.initMutationEvent
Mutation name event module (sin implementar en Gecko a Junio 2006)	"MutationNameEvent"	event.initMutationNameEvent
eventos de texto	"TextEvent" (Gecko también implementa "TextEvents")	event.initTextEvent
eventos de teclado	"KeyboardEvent" (Gecko también implementa "KeyEvents")	event.initKeyEvent (específico de Gecko; la especificación de eventos DOM 3 en desarrollo, usa initKeyboardEvent en su lugar)
eventos básicos	"Event" (Gecko también implementa "Events")	event.initEvent
SVG 1.1 Scripting
SVG	"SVGEvents" (Gecko también implementa "SVGEvent")	event.initEvent
	"SVGZoomEvents" (Gecko también implementa "SVGZoomEvent")	event.initUIEvent
Gecko implementa otros tipos de Eventos
-	"MouseScrollEvents", "PopupEvents"	event.initMouseEvent
	"PopupBlockedEvents"	event.initPopupBlockedEvent
	"XULCommandEvent", "XULCommandEvents"	event.initCommandEvent

La razón por la que algunos eventos pueden crearse a partir de dos tipos distintos, es que la especificación DOM Level 3 Events ha cambiado de forma que las cadenas de tipo de eventos son únicas, mientras que se mantiene la compatibilidad con modelos anteriores que admiten nombres plurales.

[editar] Especificaciones

DOM Level 2 Events: createEvent

DOM Level 3 Events: createEvent