做網頁前端時,瀏覽器差異是繞不開的課題。這次專案就踩到一個經典問題:微信的導航欄標題是直接讀頁面的 title,但我們做的是單頁應用(SPA),整頁只在第一次載入時完整刷新,後續都是局部更新。也就是說,標題必須靠 JavaScript 動態改。
一開始用的是最直觀的三種寫法:
document.title = "微信導航欄想要顯示的內容";
$("title").text("微信導航欄想要顯示的內容");
document.getElementsByTagName("title")[0].innerText = "微信導航欄想要顯示的內容";
結果在 Android 上一切正常,iOS 的微信瀏覽器卻完全沒反應——標題就是不動。
解法
var $body = $('body');
document.title = 'the title you want to set';
var $iframe = $("<iframe style='display:none;' src='/favicon.ico'></iframe>");
$iframe.on('load', function() {
setTimeout(function() {
$iframe.off('load').remove();
}, 0);
}).appendTo($body);
為什麼這樣有效?
關鍵在於 iOS 微信瀏覽器的行為:它在首次載入頁面、初始化 title 之後,就不再監聽 document.title 的變化了。所以你改得再多次,它也不會更新導航欄。
但這個「監聽」其實是被 iframe 的載入/卸載觸發的。因此上面的做法先改標題,再插入一個內容為空的 iframe,等它 load 完成後立刻移除——這一整套動作會促使瀏覽器重新讀取並刷新標題。
那個 display:none 為什麼必要
如果 iframe 是正常顯示的,插入與移除的過程中,iOS 上會出現幾毫秒的閃動(一個灰色方塊);Android 上更糟,灰框會留在畫面上不消失。把樣式設為 display: none 之後,iframe 脫離版面文本流,載入與刪除都不會觸發頁面重繪,也就不會有閃動的問題。
順帶一提,src 指向 /favicon.ico 也是刻意的:這個路徑幾乎一定存在、回應極小、而且不會有跨網域問題,載入最快。
如果要支援更老的環境
這段程式碼依賴 jQuery。若專案沒有引入 jQuery,用原生寫法也完全可行:
document.title = 'the title you want to set';
var iframe = document.createElement('iframe');
iframe.style.display = 'none';
iframe.src = '/favicon.ico';
iframe.onload = function () {
setTimeout(function () {
iframe.parentNode && iframe.parentNode.removeChild(iframe);
}, 0);
};
document.body.appendChild(iframe);
另外提醒兩點:這是一個 workaround,微信版本更新後行為可能改變,建議包成一個共用函式並在註解裡寫明原因,方便日後維護或移除;如果這個 hack 失效,退路是使用微信 JS-SDK 的 wx.setNavigationBarTitle(需先做簽名驗證),那是官方提供的正規做法。
以上就是 iOS 微信瀏覽器標題無法動態修改的成因與解法整理,核心觀念是「瀏覽器只在特定時機重新讀取 title」,理解這一點之後,同類型的相容性問題也比較容易找到切入點。