BeforeUnloadEvent: returnValue 屬性

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

BeforeUnloadEvent 介面的 returnValue 屬性,當設定為真值時,會在使用者嘗試關閉或重新載入頁面,或者導航到其他地方時,觸發瀏覽器生成的確認對話方塊,詢問使用者是否確實想要離開該頁面。這旨在幫助防止未儲存的資料丟失。

注意: returnValue 是一項遺留功能,最佳實踐是透過在 BeforeUnloadEvent 物件上呼叫 Event.preventDefault() 來觸發對話方塊,同時也要設定 returnValue 以支援舊版瀏覽器。有關最新、詳細的指導,請參閱 beforeunload 事件參考。

returnValue 初始化為空字串 ("") 值。

將其設定為幾乎任何 真值 都會導致在頁面關閉/重新載入時觸發對話方塊,但請注意,它還需要 粘性啟用。換句話說,僅當框架或任何嵌入式框架接收到使用者手勢或使用者互動時,瀏覽器才會顯示對話方塊。如果使用者從未與頁面進行過互動,那麼就沒有需要儲存的使用者資料,因此對話方塊沒有合法的用例。

注意: 對話方塊中會顯示一個瀏覽器指定的通用字串。此字串無法透過網頁程式碼控制。

示例

最佳實踐示例,請參閱 beforeunload 事件參考頁面。

規範

規範
HTML
# dom-beforeunloadevent-returnvalue

瀏覽器相容性