HTML DOM removeEventListener()メソッド
例
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() メソッドで追加されたイベントハンドラを削除します(「その他の例」でクロスブラウザの解決策を参照)。
構文
パラメータ値
| パラメータ | 説明 |
|---|---|
| event | 必須。削除するイベント名。 注意:"on" プレフィックスを使用しないでください。たとえば、"onclick" ではなく "click" を使用します。 ヒント:すべての HTML DOM イベントは、私たちの完全なHTML DOM Event オブジェクトリファレンスを参照できます。。 |
| function | 必須。削除する関数を指定します。 |
| useCapture | オプション。イベントハンドラを削除するフェーズを指定するブール値。 可能な値:
|
技術詳細
| DOM バージョン: | DOM Level 2 events |
|---|---|
| 戻り値: | 戻り値なし |
| 変更履歴: | Firefox 6 と Opera 12.0 では useCapture パラメータはオプションです。(Chrome、IE、Safari では以前からオプションでした)。 |
その他の例
例
ブラウザが removeEventListener() メソッドをサポートしていない場合は、detachEvent() メソッドを使用して実装できます。
この例は、クロスブラウザの解決策を示しています:
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // IE 8 およびそれ以前の IE バージョン
document.detachEvent("onmousemove", myFunction);
}
試してみる »
関連記事
JavaScript チュートリアル:HTML DOM EventListener
JavaScript リファレンス:element.removeEventListener()
その他の拡張機能
Document オブジェクト