萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

微信內置瀏覽器私有接口 WeixinJSBridge 詳細介紹:分享、隱藏工具欄/選單、初始化就緒事件

前言

微信內置瀏覽器提供私有 WeixinJSBridge 物件,透過 on 監聽菜單按鈕點擊、invoke 呼叫原生分享、call 控制 UI (隱藏工具欄/右上角選單)。本文系統整理各功能調用方式、參數、回調與初始化時機。

核心功能分類

1. 綁定右上角選單按鈕 (on)

用戶點擊右上角「...」選單中的「發送給朋友」、「分享到朋友圈」、「分享到微博」時觸發對應事件,可在回調中 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
        });
    });
}

2. 初始化就緒事件 (WeixinJSBridgeReady)

必須等待此事件後才能調用任何 WeixinJSBridge 方法,否則報錯 undefined。

if (document.addEventListener) {
    document.addEventListener('WeixinJSBridgeReady', bindShare, false);
} else if (document.attachEvent) {
    document.attachEvent('WeixinJSBridgeReady', bindShare);
    document.attachEvent('onWeixinJSBridgeReady', bindShare); // 兼容極舊版本
}

3. UI 控制 (call)

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>

遷移建議:微信 JS-SDK (wx)

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 控制、支付、地圖、錄音等豐富能力。

copyright © 萬盛學電腦網 all rights reserved