在微信內建瀏覽器裡做 H5,a 標籤失效是很典型的坑,而且往往「多跳幾次之後才出現」,讓人一時抓不到原因。
各頁面之間全靠 a 連結跳轉,來回切換幾次後,要從其他頁回首頁時,微信頂端跑出了載入進度條,畫面卻停在原處,沒有任何反應。
範圍:只在微信內建瀏覽器出現,手機自帶 Safari/Chrome 都正常。
把原本沒有 query 的連結補上一個自訂參數即可:
<a href="https://www.baidu.com">百度一下</a>
改成:
<a href="https://www.baidu.com?love">百度一下</a>
參數名稱與值可以任意(?love、?_t=1、?from=wx 都行)。原理是微信的 WebView 會快取頁面狀態,網址完全相同時它認為「沒有新東西要載入」,於是進度條跑完卻不刷新;讓 URL 每次都略有差異,就能強迫它重新請求。
實務上更推薦用時間戳當版本參數,避免快取:
var url = 'home.html?t=' + new Date().getTime();
<a href="tel:400-4000-0000">XXX</a>
這個寫法在手機瀏覽器中會跳出「是否撥打」,但在微信 5.0.1 以上的部分安卓機型上會失效。有人回報把 href 換成 link 屬性可以救回一部分機型:
<a link="tel:400-4000-0000">XXX</a>
但這並非通用解,仍與微信客戶端版本和 ROM 有關。較穩定的替代方案是改用微信的 JS-SDK 或頁面內自製撥號提示(先彈出號碼讓使用者長按複製),並在 iOS 與 Android 各自實測。
用事件代理統一攔截 a 的預設行為,改由 location.href 導向,可以避開部分 WebView 的既定行為:
$(document).on('click', 'a', function (event) {
event.preventDefault();
var href = $(event.target).attr('href');
if (!href) {
href = $(event.target).parent().attr('href'); // 點到子元素時往上找
}
if (href && href !== '#' && href.indexOf('javascript:') !== 0) {
location.href = href;
}
});
要注意這段會攔下「所有」連結,因此像 tel:、mailto: 這種特殊協定要另外排除,否則反而更生不了效。
document.addEventListener('WeixinJSBridgeReady', function onBridgeReady() {
WeixinJSBridge.call('hideToolbar');
});
這個做法屬於舊版私有介面,微信後續版本多已改由 JS-SDK 的 hideOptionMenu/hideMenuItems 取代,且必須先完成簽名驗證。新專案請直接走官方 JS-SDK,別再依賴 WeixinJSBridge 的未公開行為。
遇到跳轉失效時,我通常這樣查:先在微信以外的瀏覽器開同一個網址確認程式本身沒問題;再用微信的「 debugging 」模式(在手機微信中開啟 TBS 或 vConsole)看 Console 有沒有報錯;最後才把 URL 加時間戳、檢查是不是快取或 history 堆疊造成的。多數案例會落在快取這一環。