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

指定されたタイプの イベント を作成します。返されるオブジェクトは初めに初期化する必要があり、その後で element.dispatchEvent へ渡すことができます。

構文

var event = document.createEvent(type);
  • event は作成された Event オブジェクトです。
  • type は作成するイベントタイプを表す文字列です。取り得るイベントタイプは、"UIEvents""MouseEvents""MutationEvents""HTMLEvents" のいずれかです。詳しくは 注意点 の項目を参照してください。

// イベントを作成します。
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);

注意点

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

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

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

仕様書

関連情報

ドキュメントのタグと貢献者

タグ: 
このページの貢献者: yyss, fscholz, jsx, ethertank, Yukoba, Kohei
最終更新者: yyss,