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> |
イベントオブジェクト その他の拡張