onbeforeunloadイベント
定義と使用方法
onbeforeunloadイベントは、ドキュメントがアンラウンドされる際に発生します。
このイベントでは、確認ダイアログにメッセージを表示し、ユーザーに現在のページに留まるべきか、それとも離れるべきかを通知することができます。
確認ダイアログに表示されるデフォルトメッセージは、異なるブラウザによって異なります。ただし、標準メッセージは「このページを離れる本当にいいですか?」に似ています。このメッセージは削除できません。
ただし、カスタムメッセージとデフォルトメッセージを一緒に書けることがあります。このページの最初の例を参照してください。注記:Internet Explorerのみに適用されます。
注記:onbeforeunloadイベントが<body>要素に割り当てられていない場合、必ずそのイベントをwindowオブジェクトに割り当て/追加し、returnValue属性を使用してカスタムメッセージを作成する必要があります(以下の構文例を参照してください)。
構文
HTMLで:
<要素 onbeforeunload="myScript">
JavaScriptで:
オブジェクト.onbeforeunload = function(){myScript};
JavaScriptでaddEventListener()メソッドを使用する:
オブジェクト.addEventListener("beforeunload", myScript);
注記:Internet Explorer 8またはそれ以前のバージョンではサポートされていません addEventListener() メソッド。
技術的な詳細
バブル: | サポートされていません |
---|---|
キャンセル可能: | サポート |
イベントタイプ: | ユーザーインターフェースから生成された場合、Uiイベント。もしそうでない場合 イベント。 |
サポートする HTML タグ: | <body> |
DOM バージョン: | レベル2 イベント |
ブラウザサポート
表の数字は、そのイベントを完全にサポートする最初のブラウザバージョンを示しています。
イベント | Chrome | IE | Firefox | Safari | Opera |
---|---|---|---|---|---|
onbeforeunload | サポート | サポート | サポート | サポート | 15.0 |