HTML DOM removeEventListener()メソッド

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

例

addEventListener() メソッドで追加された "mousemove" イベントを削除します:

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

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

試してみる »

定義と使用

document.removeEventListener() メソッドは、document.addEventListener()メソッドで追加されたイベントハンドラを削除するために使用されます。

注意:イベントハンドラを削除するには、addEventListener() の実行関数は外部関数を使用する必要があります(上記の例の myFunction のように)。

匿名関数、たとえば "document.removeEventListener("event", function(){ myScript"});" のようなイベントは削除できません。

ヒント:使用 element.addEventListener()とelement.removeEventListener()メソッドを使用して、指定された要素のイベントハンドラを追加または削除します。


ブラウザサポート

表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。

メソッド
removeEventListener() 1.0 9.0 1.0 1.0 7.0

注意:Internet Explorer 8 およびそれ以前の IE バージョンは removeEventListener() メソッドをサポートしておらず、Opera 7.0 およびそれ以前の Opera バージョンもサポートしていません。ただし、この関数をサポートしていないブラウザでは、次を使用できます。detachEvent()メソッドを使用して、attachEvent() メソッドで追加されたイベントハンドラを削除します(「その他の例」でクロスブラウザの解決策を参照)。


構文

document.removeEventListener(event, function, useCapture)

パラメータ値

パラメータ 説明
event 必須。削除するイベント名。

注意:"on" プレフィックスを使用しないでください。たとえば、"onclick" ではなく "click" を使用します。

ヒント:すべての HTML DOM イベントは、私たちの完全なHTML DOM Event オブジェクトリファレンスを参照できます。。
function 必須。削除する関数を指定します。
useCapture オプション。イベントハンドラを削除するフェーズを指定するブール値。

可能な値:
  • true - イベントハンドラはキャプチャフェーズで削除されます
  • false - デフォルト。イベントハンドラはバブリングフェーズで削除されます
注意:イベントハンドラを2回追加した場合(1回はキャプチャフェーズ、もう1回はバブリングフェーズ)、そのイベントを個別に削除する必要があります。

技術詳細

DOM バージョン: DOM Level 2 events
戻り値: 戻り値なし
変更履歴: Firefox 6 と Opera 12.0 では useCapture パラメータはオプションです。(Chrome、IE、Safari では以前からオプションでした)。


その他の例

例

ブラウザが removeEventListener() メソッドをサポートしていない場合は、detachEvent() メソッドを使用して実装できます。

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

if (document.removeEventListener) { // IE 8 およびそれ以前の IE バージョンを除くすべてのブラウザ
    document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // IE 8 およびそれ以前の IE バージョン
    document.detachEvent("onmousemove", myFunction);
}

試してみる »


関連記事

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

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


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

その他の拡張機能