onbeforeunloadイベント
例
ページがアンロードされようとしているときにJavaScriptを実行します。
<body onbeforeunload="return myFunction()">
定義と使用法
onbeforeunloadイベントは、ドキュメントがアンロードされようとしているときに発生します。
このイベントを使用すると、確認ダイアログボックスにメッセージを表示して、ユーザーが現在のページに留まるか離れるかを通知できます。
確認ボックスに表示されるデフォルトのメッセージは、ブラウザによって異なります。ただし、標準のメッセージは「このページを離れてもよろしいですか?」のようなものです。このメッセージは削除できません。
ただし、デフォルトのメッセージと一緒にカスタムメッセージを作成できます。このページの最初の例を参照してください。注:これはInternetExplorerでのみ機能します。
注: onbeforeunloadイベントが<body>要素に割り当てられていない場合は、ウィンドウオブジェクトにイベントを割り当て/アタッチし、returnValueプロパティを使用してカスタムメッセージを作成する必要があります(以下の構文例を参照)。
ブラウザのサポート
表の数字は、イベントを完全にサポートする最初のブラウザーバージョンを示しています。
Event | |||||
---|---|---|---|---|---|
onbeforeunload | Yes | Yes | Yes | Yes | 15.0 |
構文
HTMLの場合:
<element onbeforeunload="myScript">
JavaScriptの場合:
object.onbeforeunload = function(){myScript};
JavaScriptでは、addEventListener()メソッドを使用します。
object.addEventListener("beforeunload", myScript);
注: addEventListener ()メソッドは、Internet Explorer8以前のバージョンではサポートされていません。
技術的な詳細
泡: | 番号 |
---|---|
キャンセル可能: | はい |
イベントタイプ: | ユーザーインターフェイスから生成された場合はUiEvent 、それ以外の場合はEvent |
サポートされているHTMLタグ: | <本体> |
DOMバージョン: | レベル2のイベント |