微信內置瀏覽器提供私有 WeixinJSBridge 物件,透過 on 監聽菜單按鈕點擊、invoke 呼叫原生分享、call 控制 UI (隱藏工具欄/右上角選單)。本文系統整理各功能調用方式、參數、回調與初始化時機。
用戶點擊右上角「...」選單中的「發送給朋友」、「分享到朋友圈」、「分享到微博」時觸發對應事件,可在回調中 invoke 自定義分享內容。
function bindShare() {
// 發送給好友
WeixinJSBridge.on('menu:share:appmessage', function (argv) {
WeixinJSBridge.invoke('sendAppMessage', {
"appid": "", // 可留空
"img_url": shareImgUrl, // 分享圖片
"img_width": "120",
"img_height": "120",
"link": shareLink, // 分享鏈接
"desc": "分享描述",
"title": "分享標題"
}, function (res) { /* 回調可為空 */ });
});
// 分享到朋友圈
WeixinJSBridge.on('menu:share:timeline', function (argv) {
WeixinJSBridge.invoke('shareTimeline', {
"appid": "",
"img_url": shareImgUrl,
"img_width": "120",
"img_height": "120",
"link": shareLink,
"desc": "分享描述",
"title": "分享標題"
});
});
// 分享到微博 (較少用)
WeixinJSBridge.on('menu:share:weibo', function (argv) {
WeixinJSBridge.invoke('shareWeibo', {
"content": shareTitle + ' ' + shareLink,
"url": shareLink
});
});
}
必須等待此事件後才能調用任何 WeixinJSBridge 方法,否則報錯 undefined。
if (document.addEventListener) {
document.addEventListener('WeixinJSBridgeReady', bindShare, false);
} else if (document.attachEvent) {
document.attachEvent('WeixinJSBridgeReady', bindShare);
document.attachEvent('onWeixinJSBridgeReady', bindShare); // 兼容極舊版本
}
WeixinJSBridge.call('hideToolbar'); // 隱藏底部工具欄 (舊版有效,新版可能無效)
WeixinJSBridge.call('showToolbar'); // 顯示底部工具欄
WeixinJSBridge.call('hideOptionMenu'); // 隱藏右上角「...」選單按鈕
WeixinJSBridge.call('showOptionMenu'); // 顯示右上角選單按鈕
<!doctype html>
<html><head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=no">
<title>WeixinJSBridge 測試</title>
<script>
var shareLink = 'https://www.3lian.net';
var shareImgUrl = '';
var shareTitle = '極客標簽';
function bindShare() {
WeixinJSBridge.on('menu:share:appmessage', function (argv) {
WeixinJSBridge.invoke('sendAppMessage', {
"appid": "", "img_url": shareImgUrl, "img_width": "120", "img_height": "120",
"link": shareLink, "desc": "極客標簽--https://www.jb51.net", "title": "發現 極客標簽"
});
});
WeixinJSBridge.on('menu:share:timeline', function (argv) {
WeixinJSBridge.invoke('shareTimeline', {
"appid": "", "img_url": shareImgUrl, "img_width": "120", "img_height": "120",
"link": shareLink, "desc": "極客標簽--https://www.jb51.net", "title": "發現 極客標簽"
});
});
alert('綁定成功!請點擊右上角選單分享。');
}
function hideMenu() { WeixinJSBridge.call('hideOptionMenu'); }
function showMenu() { WeixinJSBridge.call('showOptionMenu'); }
// 初始化
if (document.addEventListener) {
document.addEventListener('WeixinJSBridgeReady', bindShare, false);
} else if (document.attachEvent) {
document.attachEvent('WeixinJSBridgeReady', bindShare);
document.attachEvent('onWeixinJSBridgeReady', bindShare);
}
</script>
</head>
<body>
<button onclick="hideMenu()">隱藏右上角選單</button>
<button onclick="showMenu()">顯示右上角選單</button>
<p>請在微信中打開此頁面測試。</p>
</body></html>
WeixinJSBridge 為內部非公開接口,隨時可能變更。官方推薦使用 微信 JS-SDK:
// 1. 引入 JS-SDK
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
// 2. 配置簽名 (需後端提供 signature, nonceStr, timestamp, appId)
wx.config({
debug: false, appId: '', timestamp: 0, nonceStr: '', signature: '',
jsApiList: ['updateAppMessageShareData', 'updateTimelineShareData', 'hideOptionMenu', 'showOptionMenu']
});
// 3. 就緒回調
wx.ready(function () {
// 自定義分享給朋友
wx.updateAppMessageShareData({
title: '標題', desc: '描述', link: 'https://example.com', imgUrl: 'https://example.com/img.jpg'
});
// 自定義分享到朋友圈
wx.updateTimelineShareData({
title: '標題', link: 'https://example.com', imgUrl: 'https://example.com/img.jpg'
});
// 隱藏/顯示選單
wx.hideOptionMenu(); // wx.showOptionMenu();
});
WeixinJSBridge 是微信早期內部接口,功能強大但非標準、文檔缺乏、相容性不可控。現代微信開發**必須使用官方 JS-SDK (wx)**,透過後端簽名驗證域名合法性,獲得穩定、受支援的分享、UI 控制、支付、地圖、錄音等豐富能力。