在微信內開啟的網頁,常需要自訂分享出去的標題、描述與縮圖。早期做法是透過 WeixinJSBridge 這個橋接物件,攔下微信右上角選單的分享動作,再自行帶入參數。以下把完整結構說明清楚。
整段程式的可變部分其實只有四個值:縮圖網址、要分享出去的連結、描述文字、標題。把它們抽成變數,後續要換內容只改這幾行即可。
var imgUrl = 'https://example.com/share-cover.jpg'; // 分享縮圖 var lineLink = 'https://example.com/activity'; // 點擊後前往的連結 var descContent = '活動說明文字'; // 分享描述 var shareTitle = '活動標題'; // 分享標題 var appid = 'wxXXXXXXXXXXXXXXXX'; // 微信公眾號 appid
微信的分享分成三種場景:傳給好友、分享到朋友圈、分享到微博。各自呼叫不同的 bridge 方法。
function shareFriend() {
WeixinJSBridge.invoke('sendAppMessage', {
"appid": appid,
"img_url": imgUrl,
"img_width": "640",
"img_height": "640",
"link": lineLink,
"desc": descContent,
"title": shareTitle
}, function (res) {
_report('send_msg', res.err_msg);
});
}
function shareTimeline() {
WeixinJSBridge.invoke('shareTimeline', {
"img_url": imgUrl,
"img_width": "640",
"img_height": "640",
"link": lineLink,
"desc": descContent,
"title": shareTitle
}, function (res) {
_report('timeline', res.err_msg);
});
}
function shareWeibo() {
WeixinJSBridge.invoke('shareWeibo', {
"content": descContent,
"url": lineLink
}, function (res) {
_report('weibo', res.err_msg);
});
}
要注意朋友圈的介面與好友不同:它不顯示 desc,只吃標題與縮圖。
WeixinJSBridge 不是頁面一載入就存在,微信內建瀏覽器完成內部初始化後才會觸發 WeixinJSBridgeReady 事件。所以監聽必須寫在這個事件裡,否則會拿到 undefined。
document.addEventListener('WeixinJSBridgeReady', function onBridgeReady() {
// 傳送給好友
WeixinJSBridge.on('menu:share:appmessage', function (argv) {
shareFriend();
});
// 分享到朋友圈
WeixinJSBridge.on('menu:share:timeline', function (argv) {
shareTimeline();
});
// 分享到微博
WeixinJSBridge.on('menu:share:weibo', function (argv) {
shareWeibo();
});
}, false);
最後在 body 放一個佔位標題即可:
<h1>頁面內容</h1>
必須誠實說明:WeixinJSBridge 是微信早期的內部橋接方式,參數格式與可用性都隨版本變動過,如今不建議再用於新專案。
現行的標準做法是使用微信 JS-SDK,流程大致是:後端用目前取得的 access_token 算出 jsapi_ticket,再依 noncestr、時間戳與頁面網址產生簽章;前端引入 jweixin 之後呼叫 wx.config() 注入簽章資訊;最後透過 wx.ready() 註冊分享內容。
wx.ready(function () {
wx.updateAppMessageShareData({
title: shareTitle,
desc: descContent,
link: lineLink,
imgUrl: imgUrl
});
wx.updateTimelineShareData({
title: shareTitle,
link: lineLink,
imgUrl: imgUrl
});
});
差別在於:JS-SDK 的簽章機制確保了呼叫來自有權限的頁面,參數結構也穩定得多。若你正在實作這功能,請直接從 JS-SDK 開始,把上面的 WeixinJSBridge 範例當作理解「微信如何攔截分享動作」的歷史背景來讀。