DOM

Document.createEvent() メソッド

 編集:2022.10.14 by T.A.

[Edge]。非推奨。→

警告: createEvent とともに使用される多くのメソッド(initCustomEvent など)は非推奨です。代わりに イベントのコンストラクター を使用してください。

指定された型の イベント を作成します。

返されるオブジェクトは最初に初期化する必要があり、その後で EventTarget.dispatchEvent へ渡すことができます。

構文
Document.createEvent(type)
Document 実質 document でしょう。
type 作成するイベント型を表す文字列です。取り得るイベント型は "UIEvents"、"MouseEvents"、"MutationEvents"、"HTMLEvents" のいずれかです(¶EventCustomEventの例もあるようですが)。詳しくは“”の項目を参照してください。
戻り値

Event オブジェクトです。

// イベントを作成します。
var event = document.createEvent('Event');

// イベントの名前を 'build' に定義します。
event.initEvent('build', true, true);

// イベントを待受します。
elem.addEventListener('build', function (e) {
  // e.target が elem に対応する
}, false);

// ターゲットは任意の Element やほかの EventTarget にすることができます。
elem.dispatchEvent(event);

↑buildの意味が解らず。

createEvent() に渡すのに適したイベント型を表す文字列は DOM 標準で定義されています。ステップ 2 の表をご覧ください。現在はほとんどのイベント オブジェクトにコンストラクターがあり、それらはイベント オブジェクトのインスタンスを生成するために推奨される、現代的な方法であることに注意してください。

Gecko は非標準のイベント オブジェクトの別名をサポートしています。詳細は以下の表を参照してください。

標準イベント オブジェクト Gecko が対応する別名 イベントモジュール
TextEvent TextEvents テキスト イベント モジュール
KeyboardEvent KeyEvents キーボード イベント モジュール
Event Events 基本イベント モジュール

仕様書より

type インタフェース 仕様(空欄はこの仕様)
"beforeunloadevent" BeforeUnloadEvent [HTML]
"compositionevent" CompositionEvent [UIEVENTS]
"customevent" CustomEvent
"devicemotionevent" DeviceMotionEvent [DEVICE-ORIENTATION]
"deviceorientationevent" DeviceOrientationEvent [DEVICE-ORIENTATION]
"dragevent" DragEvent [HTML]
"event" Event
"events" Event
"focusevent" FocusEvent [UIEVENTS]
"hashchangeevent" HashChangeEvent [HTML]
"htmlevents" Event
"keyboardevent" KeyboardEvent [UIEVENTS]
"messageevent" MessageEvent [HTML]
"mouseevent" MouseEvent [UIEVENTS]
"mouseevents" MouseEvent [UIEVENTS]
"storageevent" StorageEvent [HTML]
"svgevents" Event
"textevent" CompositionEvent [UIEVENTS]
"touchevent" TouchEvent [TOUCH-EVENTS]
"uievent" UIEvent [UIEVENTS]
"uievents" UIEvent [UIEVENTS]

HTML:

<SPAN id=IdSpan>SPAN要素:テストです</SPAN>

JavaScript:

E=document.createEvent('Event');  //eventのイベント生成。
E.initEvent('click', true, true); //そのイベントをclickイベントで初期化する。
IdSpan.addEventListener('click', function(eve){ //SPAN要素にbuildイベントを割り当てる。eveにEventオブジェクトが入る。
  alert(eve); //eveを表示する
});

テスト