微信內網頁右上角那三個小點,展開後就是一個選單:發送給好友、分享到朋友圈、分享到騰訊微博等等。上一篇文章講了怎麼「執行」分享,這篇要講更關鍵的一半——怎麼「攔下」使用者點選單的動作,並在它真正送出前把內容換成我們要的樣子。

前提:WeixinJSBridge 只在微信內開啟的網頁中有效,用電腦瀏覽器開啟什麼都不會發生。
function sendMessage() {
WeixinJSBridge.on('menu:share:appmessage', function (argv) {
alert("發送給好友");
});
}
只要呼叫一次 sendMessage(),使用者之後點「發送給好友」時就會先經過這段回呼。事件名稱的命名規則很直白:menu:share: 加上對應的功能代號,appmessage 是好友、timeline 是朋友圈、weibo 是微博。
光是 alert 沒有意義,真正的用法是在回呼裡呼叫 invoke:
WeixinJSBridge.invoke('sendAppMessage', {
"appid": "", // 留空即可
"img_url": imgUrl, // 分享縮圖
"img_width": "120",
"img_height": "120",
"link": url, // 點擊後的目標網址
"desc": "我是一個介紹",
"title": "標題,再簡單不過了。"
}, function (res) {
/* 回呼建議留空,避免多餘彈窗 */
});
把上面那段 invoke 從 on 裡拿出來、在頁面載入時直接呼叫,邏輯上說得通,實測卻完全沒反應。必須先讓使用者手動點一次右上角的「發送給好友」、等通訊錄彈出後再返回,之後直接呼叫才會生效——看起來像是微信內部要先做某種初始化。因此正確做法就是把它嵌進 on 的綁定裡,讓使用者的每一次點擊都觸發一次完整流程:
function sendMessage() {
WeixinJSBridge.on('menu:share:appmessage', function (argv) {
WeixinJSBridge.invoke('sendAppMessage', {
"appid": "",
"img_url": imgUrl,
"img_width": "120",
"img_height": "120",
"link": url,
"desc": "我是一個介紹",
"title": "標題,再簡單不過了。"
}, function (res) { /* 回呼留空 */ });
});
}
這樣一來,使用者點「發送給好友」,就會直接跳到通訊錄挑選單一好友,不必再經歷一次預設流程。
function sendMessage() {
// ……此處接上面的 sendAppMessage 綁定……
WeixinJSBridge.on('menu:share:timeline', function (argv) {
WeixinJSBridge.invoke('shareTimeline', {
"appid": "",
"img_url": imgUrl,
"img_width": "120",
"img_height": "120",
"link": url,
"desc": "我是一個介紹",
"title": "標題,再簡單不過了。"
}, function (res) { /* 回呼留空 */ });
});
}
仔細比對就會發現:只有 on 的事件名(menu:share:timeline)和 invoke 的 API 名(shareTimeline)不同,參數結構一模一樣。這個對稱性讓整套 API 很好記。
WeixinJSBridge.on('menu:share:weibo', function (argv) {
WeixinJSBridge.invoke('shareWeibo', {
"content": dataForWeixin.title + ' ' + dataForWeixin.url,
"url": dataForWeixin.url
}, function (res) {});
});
微信內的 WebView 需要一點時間初始化。如果在 WeixinJSBridge 還不存在時就呼叫,所有接口都是 undefined,程式會直接丟出錯誤。解法是監聽 WeixinJSBridgeReady 事件:
if (document.addEventListener) {
document.addEventListener('WeixinJSBridgeReady', sendMessage, false);
} else if (document.attachEvent) {
// 舊 IE 的 attachEvent,且事件名要帶 on 前綴
document.attachEvent('WeixinJSBridgeReady', sendMessage);
document.attachEvent('onWeixinJSBridgeReady', sendMessage);
}
這是整套做法中最重要的一段。少了它,使用者在弱網或冷啟動時會有一半機率遇到「分享沒反應」。
WeixinJSBridge.call('hideToolbar'); // 隱藏右下方工具列
WeixinJSBridge.call('showToolbar'); // 顯示右下方工具列
WeixinJSBridge.call('hideOptionMenu'); // 隱藏右上角三個點按鈕
WeixinJSBridge.call('showOptionMenu'); // 顯示右上角三個點按鈕
call() 是「直接呼叫、不需要參數、沒有回呼」的簡化形式,跟 invoke() 屬於同一家族。
把上面所有片段組起來,就是一個可以上機實測的頁面:
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
<title>微信接口測試</title>
<script>
var dataForWeixin = {
title: "發現 極客標簽 - 做最棒的極客知識分享平台",
url: "https://www.example.com",
imgUrl: ""
};
function sendMessage() {
WeixinJSBridge.on('menu:share:appmessage', function () {
WeixinJSBridge.invoke('sendAppMessage', {
"appid": "", "img_url": dataForWeixin.imgUrl,
"img_width": "120", "img_height": "120",
"link": dataForWeixin.url, "desc": "極客標簽",
"title": dataForWeixin.title
}, function (res) {});
});
WeixinJSBridge.on('menu:share:timeline', function () {
WeixinJSBridge.invoke('shareTimeline', {
"appid": "", "img_url": dataForWeixin.imgUrl,
"img_width": "120", "img_height": "120",
"link": dataForWeixin.url, "desc": "極客標簽",
"title": dataForWeixin.title
}, function (res) {});
});
alert("調用成功!現在可以通過右上角按鈕分享給朋友或者朋友圈!");
}
function hideMenu() { WeixinJSBridge.call('hideOptionMenu'); }
function showMenu() { WeixinJSBridge.call('showOptionMenu'); }
function hideTool() { WeixinJSBridge.call('hideToolbar'); }
function showTool() { WeixinJSBridge.call('showToolbar'); }
if (document.addEventListener) {
document.addEventListener('WeixinJSBridgeReady', sendMessage, false);
} else if (document.attachEvent) {
document.attachEvent('WeixinJSBridgeReady', sendMessage);
document.attachEvent('onWeixinJSBridgeReady', sendMessage);
}
// 判斷目前是否在微信中開啟
var ua = navigator.userAgent.toLowerCase();
if (ua.match(/MicroMessenger/i) == "micromessenger") {
console.log("微信環境");
} else {
alert("調用失敗,請用微信掃描二維碼打開網頁!");
}
</script>
</head>
<body>
<center>
<h2>分享請點擊右上角</h2>
<button onclick="hideMenu()">隱藏右上角三個點</button><br><br>
<button onclick="showMenu()">顯示右上角三個點</button><br><br>
<button onclick="hideTool()">隱藏下面導條</button><br><br>
<button onclick="showTool()">顯示下面導條</button><br><br>
</center>
</body>
</html>
這套 WeixinJSBridge 私有接口屬於微信的早期方案,特色是「不需要 appId、不需要後端簽名」,代價是完全沒有身分驗證——任何人都能做出宣稱是某個網站的分享卡片。微信後續推出 JS-SDK,用後端簽名把這個漏洞補起來,同時也逐步收緊了私有接口的可用性。
因此這份內容的定位是「理解微信 WebView 是怎麼運作」的教材:它清楚示範了事件綁定的命名慣例、err_msg 的回傳格式、以及「橋樑物件尚未就緒」這個所有跨層通訊都會遇到的經典問題。實際 production 環境請以 JS-SDK 為準,並把簽名計算放在伺服器端。