HTML DOM addEventListener()メソッド

Document 对象参考手册Document オブジェクト

例

ドキュメントにクリックイベントを追加します。ユーザーがドキュメント内の任意の場所をクリックすると、id="demo" の <p> 要素に "Hello World" を出力します:

document.addEventListener("click", function(){ document.getElementById("demo").innerHTML = "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()ただし、このようなブラウザバージョンでは、


構文

document.addEventListener(event, function, useCapture)

パラメータ値

パラメータ 説明
event 必須。イベント名を表す文字列。

注意:「on」プレフィックスは使用しないでください。例:「onclick」の代わりに「click」を使用します。

ヒント:すべての HTML DOM イベントについては、完全なHTML DOM Event オブジェクト リファレンス。
function 必須。イベントがトリガーされた後に実行される関数を記述します。

イベントがトリガーされると、イベントオブジェクトが最初のパラメータとして関数に渡されます。イベントオブジェクトの型は特定のイベントによって異なります。たとえば、"click" イベントは MouseEvent(マウスイベント)オブジェクトに属します。
useCapture オプション。ブール値。イベントをキャプチャフェーズまたはバブリングフェーズで実行するかどうかを指定します。

可能な値:
  • true - イベントハンドラはキャプチャフェーズで実行されます
  • false - デフォルト。イベントハンドラはバブリングフェーズで実行されます

技術的な詳細

DOM バージョン: DOM Level 2 Events
戻り値: 戻り値なし
変更履歴: Firefox 6 と Opera 11.60 では、useCapture パラメータはオプションです。(Chrome、IE および Safari では常にオプションでした)。


その他の例

例

関数名を使用して外部関数を参照できます:

document.addEventListener("click", myFunction);

function myFunction() {
    document.getElementById("demo").innerHTML = "Hello World";
}

試してみる »

例

ドキュメントに多くのイベントを追加できます。追加したイベントは既存のイベントを上書きしません。

この例では、ドキュメントに2つのクリックイベントを追加する方法を示しています。

document.addEventListener("click", myFunction);
document.addEventListener("click", someOtherFunction);

試してみる »

例

ドキュメントに異なるタイプのイベントを追加できます。

この例では、ドキュメントに複数のイベントを追加する方法を示しています。

document.addEventListener("mouseover", myFunction);
document.addEventListener("click", someOtherFunction);
document.addEventListener("mouseout", someOtherFunction);

試してみる »

例

パラメータ値を渡すときは、「匿名関数」を使用してパラメータ付きの関数を呼び出します:

document.addEventListener("click", function() {
    myFunction(p1, p2);
});

試してみる »

例

<body> 要素の背景を変更:

document.addEventListener("click", function(){
    document.body.style.backgroundColor = "red";
});

試してみる »

例

removeEventListener() メソッドを使用して、addEventListener() メソッドで追加されたイベントハンドラを削除します:

// ドキュメントにイベントハンドラを追加
document.addEventListener("mousemove", myFunction);

// ドキュメントのイベントハンドラを削除
document.removeEventListener("mousemove", myFunction);

試してみる »

例

ブラウザが addEventListener() メソッドをサポートしていない場合は、attachEvent() メソッドを使用して代替できます。

次の例は、クロスブラウザの解決方法を示しています:

if (document.addEventListener) { // すべての主要ブラウザ(IE 8 およびそれ以前の IE バージョンを除く)
    document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 およびそれ以前の IE バージョン
    document.attachEvent("onclick", myFunction);
}

試してみる »


関連ページ

JavaScript チュートリアル:HTML DOM EventListener

JavaScript リファレンス:element.addEventListener()

Document 对象参考手册Document オブジェクト

その他の拡張機能