1. 開発者向けのウェブ技術
  2. Web API
  3. Document
  4. createEvent()

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Document: createEvent() メソッド

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

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

構文

js
createEvent(type)

引数

type

作成するイベント型を表す文字列です。取り得るイベント型は "UIEvents", "MouseEvents", "MutationEvents", "HTMLEvents" のいずれかです。詳しくはメモの項目を参照してください。

返値

イベントオブジェクトです。

js
// イベントを作成します。
const event = document.createEvent("Event");
// イベントの名前を 'build' に定義します。
event.initEvent("build", true, true);
// イベントを待受します。
elem.addEventListener(
 "build",
 (e) => {
 // e.target が elem に対応する
 },
 false,
);
// ターゲットは任意の Element やほかの EventTarget にすることができます。
elem.dispatchEvent(event);

メモ

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

仕様書

仕様書
DOM
# dom-document-createevent

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

AltStyle によって変換されたページ (->オリジナル) /