HTML DOM addEventListener()メソッド
例
ドキュメントにクリックイベントを追加します。ユーザーがドキュメント内の任意の場所をクリックすると、id="demo" の <p> 要素に "Hello World" を出力します:
試してみる »
定義と使用法
document.addEventListener() メソッドは、ドキュメントにイベントハンドラを追加するために使用します。
ヒント:使用できます document.removeEventListener()メソッドを使用して、addEventListener() メソッドで追加されたイベントハンドラを削除します。
ヒント:使用 element.addEventListener()メソッドを使用して、指定された要素にイベントハンドラを追加します。
ブラウザサポート
表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。
| メソッド | |||||
|---|---|---|---|---|---|
| addEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
注意:Internet Explorer 8 およびそれ以前の IE バージョンは addEventListener() メソッドをサポートしておらず、Opera 7.0 および Opera のそれ以前のバージョンもサポートしていません。attachEvent()ただし、このようなブラウザバージョンでは、
構文
パラメータ値
| パラメータ | 説明 |
|---|---|
| event | 必須。イベント名を表す文字列。 注意:「on」プレフィックスは使用しないでください。例:「onclick」の代わりに「click」を使用します。 ヒント:すべての HTML DOM イベントについては、完全なHTML DOM Event オブジェクト リファレンス。 |
| function | 必須。イベントがトリガーされた後に実行される関数を記述します。 イベントがトリガーされると、イベントオブジェクトが最初のパラメータとして関数に渡されます。イベントオブジェクトの型は特定のイベントによって異なります。たとえば、"click" イベントは MouseEvent(マウスイベント)オブジェクトに属します。 |
| useCapture | オプション。ブール値。イベントをキャプチャフェーズまたはバブリングフェーズで実行するかどうかを指定します。 可能な値:
|
技術的な詳細
| DOM バージョン: | DOM Level 2 Events |
|---|---|
| 戻り値: | 戻り値なし |
| 変更履歴: | Firefox 6 と Opera 11.60 では、useCapture パラメータはオプションです。(Chrome、IE および Safari では常にオプションでした)。 |
その他の例
例
関数名を使用して外部関数を参照できます:
function myFunction() {
document.getElementById("demo").innerHTML = "Hello World";
}
試してみる »
例
ドキュメントに多くのイベントを追加できます。追加したイベントは既存のイベントを上書きしません。
この例では、ドキュメントに2つのクリックイベントを追加する方法を示しています。
document.addEventListener("click", someOtherFunction);
試してみる »
例
ドキュメントに異なるタイプのイベントを追加できます。
この例では、ドキュメントに複数のイベントを追加する方法を示しています。
document.addEventListener("click", someOtherFunction);
document.addEventListener("mouseout", someOtherFunction);
試してみる »
例
パラメータ値を渡すときは、「匿名関数」を使用してパラメータ付きの関数を呼び出します:
myFunction(p1, p2);
});
試してみる »
例
<body> 要素の背景を変更:
document.body.style.backgroundColor = "red";
});
試してみる »
例
removeEventListener() メソッドを使用して、addEventListener() メソッドで追加されたイベントハンドラを削除します:
document.addEventListener("mousemove", myFunction);
// ドキュメントのイベントハンドラを削除
document.removeEventListener("mousemove", myFunction);
試してみる »
例
ブラウザが addEventListener() メソッドをサポートしていない場合は、attachEvent() メソッドを使用して代替できます。
次の例は、クロスブラウザの解決方法を示しています:
document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 およびそれ以前の IE バージョン
document.attachEvent("onclick", myFunction);
}
試してみる »
関連ページ
JavaScript チュートリアル:HTML DOM EventListener
JavaScript リファレンス:element.addEventListener()
その他の拡張機能
Document オブジェクト