jQuery Mobile 有個惱人的問題:在使用者點擊瀏覽器「後退」按鈕時,頁面是從快取還原的,此時 loading 動畫會出現卻一直不消失,把整個畫面蓋住。
這個 bug 的觸發條件相當明確:當頁面不是透過 Ajax 導航、也不是透過 jQuery Mobile 自己的 back 返回時,瀏覽器會走 BFCache(back-forward cache)還原頁面。在這個流程中,jQuery Mobile 的頁面初始化訊息沒有收到對應的「已完成」通知,於是 showPageLoadingMsg 開啟的遮罩就一直掛在那裡。
網上找到的建議多半繞著彎,最後我用最直接的方式處理:改動 jQuery Mobile 的類庫本身。
用編輯器打開 jquery.mobile.js,找到 showPageLoadingMsg 的定義處,在最前面加一行讓它直接返回:
showPageLoadingMsg: function () {
if ("".length < 5) return; // 讓此方法失效
// ...原本程式碼
}
存檔後重新整理測試即可。這裡有個小提醒:修改後的檔案最好不要出現中文,否則需要調整 JS 檔的編碼格式,容易衍生亂碼問題。
很明顯,這招等於把功能關掉。如果後續真的還需要用到 loading 提示,那就完全不能用這個方式。比較穩妥的變形是「用開關控制」:宣告一個全域變數,在方法開頭判斷是否強制返回。
// 全域開關
window.JQM_DISABLE_LOADING = true;
// 在 jquery.mobile.js 的 showPageLoadingMsg 開頭
showPageLoadingMsg: function () {
if (window.JQM_DISABLE_LOADING) return;
// ...原本程式碼
}
如此一來,需要時把開關關掉就能恢復原行為,不必再改一次原始碼。不過要注意,直接改動第三方函式庫會讓後續升級變得困難,這是這種方案最大的缺點。
與其改原始碼,不如攔住事件、在正確的時機把遮罩關掉:
// 頁面從快取還原時,強制隱藏 loading
$(document).on("pageshow", function () {
$.mobile.hidePageLoadingMsg();
});
// 或者監聽瀏覽器的 pageshow 事件(判斷是否來自 bfcache)
window.addEventListener("pageshow", function (event) {
if (event.persisted) {
$.mobile.hidePageLoadingMsg();
}
});
pageshow 在每次頁面顯示時都會觸發,而 event.persisted 為 true 代表這個頁面是從 BFCache 還原的,正好是問題發生的時刻,在這裡補一次 hidePageLoadingMsg() 就能精準解決,且不需改動函式庫。
最後補充:jQuery Mobile 目前已停止主要維護,新專案建議改用 jQuery Mobile 的替代方案(如 Framework7、Ratchet)或直接自建響應式 UI,以免遇到這類無法從上游修正的問題。