English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

HTML DOM addEventListener() メソッド

HTML DOM Document オブジェクト

document.addEventListener()イベントハンドラをドキュメントに追加する方法。

使用document.removeEventListener()addEventListener()メソッドと一緒に追加されたイベントハンドラを削除する方法。

使用element .addEventListener()このメソッドは、指定された要素にイベントハンドラを追加します。

文法:

document.addEventListener(event, listener, useCapture)
document.addEventListener("click", function() {
alert("Hello World!!!");
});
テストしてみる‹/›

ブラウザ互換性

このテーブルの数字は、addEventListener()メソッドを完全にサポートする最初のブラウザバージョンを指定します:

メソッド
addEventListener()1171.09

引数の値

引数説明
event(必須)イベントはどんな有効なJavaScriptイベントでもできます。イベントを使用する際には「on」接頭辞を使用しません。例えば、「click」を「onclick」、「mousedown」を「onmousedown」に置き換えます。
すべてのHTML DOMイベントのリストについては、私たちの完全なHTML DOMイベントオブジェクトリファレンス
listener(必須)イベントに対応するJavaScript関数です。
イベントが発生したとき、イベントオブジェクトは最初の引数として関数に渡されます。イベントオブジェクトのタイプは指定されたイベントに依存します。例えば、「click」イベントはMouseEventオブジェクトに属します。
useCapture(オプション)真偽値、キャプチャフェーズまたはバブルフェーズでイベントを実行するかを指定します。デフォルトはfalseです。
可能な値:
  • true-イベントリスナーはキャプチャフェーズで実行されます

  • false-イベントリスナーはバブルフェーズで実行されます

私たちのJavaScript イベント伝播チュートリアルでイベントの伝播に関する詳細情報を読む

技術的詳細

返り値:なし
DOMバージョン:DOM 2階層

さらに多くの例

クリックイベントをドキュメントに追加します。ユーザーがドキュメント内のどこかをクリックしたとき、<p>要素を使用してid="para"の「Hello World」を出力してください:

document.addEventListener("click", function() {
document.querySelector("#para").innerHTML = "Hello World!!!";
});
テストしてみる‹/›

この例では、外部の「名前付き」関数を参照しています:

document.addEventListener("click", myFunc);
function myFunc() {
   document.body.style.backgroundColor = "coral";
}
テストしてみる‹/›

ドキュメントに多くのイベントを追加できますが、既存のイベントをオーバーライドしません:

document.addEventListener("click", myFunc);
document.addEventListener("click", anotherFunc);
テストしてみる‹/›

さまざまなタイプのイベントをドキュメントに追加できます:

document.addEventListener("mouseenter", myFunc1);
document.addEventListener("click", myFunc2);
document.addEventListener("mouseout", myFunc3);
テストしてみる‹/›

パラメータ値を渡す場合、匿名関数を使用して指定された関数を呼び出します:

document.addEventListener("click", function() {
myFunc(x, y);
});
テストしてみる‹/›

他にも見てみましょう

JavaScript 教程:イベントリスナー

JavaScript 教程:イベント伝播

HTML DOM 参考リファレンス:document.removeEventListener()

HTML DOM 参考リファレンス:element .addEventListener()

HTML DOM Document オブジェクト