onbeforeunloadイベント

事件对象参考手册イベントオブジェクト

インスタンス

現在のページを離れようとするとき(リロードまたは閉じる)に JavaScript を実行する:

<body onbeforeunload="return myFunction()">

試してみる »


定義と用法

onbeforeunload イベントは、現在のページを離れようとするとき(リロードまたは閉じる)にトリガーされます。

このイベントは、ユーザーにページを閲覧し続けるか、現在のページから離れるかを促すダイアログボックスを表示するために使用できます。

ダイアログボックスのデフォルトのプロンプトメッセージはブラウザによって異なります。標準的なメッセージは「このページを離れてもよろしいですか?」のようなものです。このメッセージは削除できません。

ただし、標準メッセージと一緒にダイアログボックスに表示するカスタムメッセージを定義できます。

注意:onbeforeunload イベントを <body> 要素に指定しない場合は、window オブジェクトにイベントを追加し、returnValue プロパティを使用してカスタムメッセージを作成する必要があります(以下の構文例を参照)。

注意:Firefox ブラウザでは、デフォルトの警告メッセージのみが表示されます(カスタムメッセージは表示されません)。


ブラウザサポート

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

イベント
onbeforeunload Yes Yes Yes Yes 15.0


構文

HTML の場合:

<element onbeforeunload="myScript">試してみる

JavaScript の場合:

object.onbeforeunload=function(){myScript};試してみる

JavaScript で、addEventListener() メソッドを使用する場合:

object.addEventListener("beforeunload", myScript);試してみる

注意:Internet Explorer 8 およびそれ以前の IE バージョンではサポートされていませんaddEventListener()メソッド。


技術詳細
バブリングをサポートするか: No
キャンセルできるか: Yes
イベントタイプ: Event
サポートされている HTML タグ:  <body>


事件对象参考手册イベントオブジェクト その他の拡張