CustomEvent()

CustomEvent() コンストラクターは新しい CustomEvent を生成します。

構文

 event = new CustomEvent(typeArg, customEventInit);

引数

typeArg

DOMString で、イベントの名前を表します。

customEventInit Optional

CustomEventInit 辞書で、以下のフィールドを持ちます。

• "detail": 省略可で既定値は null であり、任意の型であり、イベントに関連付けられたイベントに依存する値です。

CustomEventInit 辞書は、 EventInit 辞書のフィールドも受け付けます。

返値

A new CustomEvent object of the specified type, with any other properties configured according to the CustomEventInit dictionary (if one was provided).

例

// add an appropriate event listener
obj.addEventListener("cat", function(e) { process(e.detail) });

// create and dispatch the event
var event = new CustomEvent("cat", {
  detail: {
    hazcheeseburger: true
  }
});
obj.dispatchEvent(event);

その他の例は、イベントの作成とトリガにあります。

仕様書

ブラウザーの対応

このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。

ポリフィル

Internet Explorer 9 以上では、 CustomEvent() の機能を以下のコードで代替することができます。

(function () {

  if ( typeof window.CustomEvent === "function" ) return false;

  function CustomEvent ( event, params ) {
    params = params || { bubbles: false, cancelable: false, detail: undefined };
    var evt = document.createEvent( 'CustomEvent' );
    evt.initCustomEvent( event, params.bubbles, params.cancelable, params.detail );
    return evt;
   }

  CustomEvent.prototype = window.Event.prototype;

  window.CustomEvent = CustomEvent;
})();

Internet Explorer 9 以上では CustomEvent オブジェクトを window に追加していますが、正しい実装では、これは関数です。

関連情報

• CustomEvent
• イベントの作成とトリガ