在微信內建瀏覽器中開發 H5 頁面,有一批只能透過 WeixinJSBridge 呼叫的專屬能力。以下整理八個實務上最常回頭查的用法。
微信提供了原生的圖片瀏覽器,只要把圖片陣列與目前顯示的網址傳進去即可,使用者就能左右滑動、雙擊放大。
var pictures = [];
angular.forEach(pitctures, function(k, i) {
pictures[i] = k.imgPath;
});
$scope.previewPics = function(currentUrl) {
if (typeof window.WeixinJSBridge != 'undefined') {
// 微信圖片集查看
WeixinJSBridge.invoke('imagePreview', {
'current': currentUrl, // 目前地址
'urls': pictures // 圖集
});
} else {
alert("請在微信中查看");
}
}
對應的頁面元素:
<div class="infoPics">
<div class="picImg" ng-repeat="picture in info.infoContent.pitctures">
<img ng-src="{{picture.imgPath}}" ng-click="previewPics(picture.imgPath)">
</div>
</div>
WeixinJSBridge.invoke('closeWindow', {}, function(res) {
// alert(res.err_msg);
});
var lineLink = 'https://../..',
imgUrl = 'https://../..',
shareTitle = '頁面標題',
descContent = '內容簡介',
appid = '';
// 判斷是否支援微信 js
if (typeof WeixinJsBridge == 'undefined') {
if (document.addEventListener) {
document.addEventListener('WeixinJsBridgeReady', onBridgeReady, false);
} else if (document.attachEvent) {
document.attachEvent('WeixinJsBridgeReady', onBridgeReady);
document.attachEvent('onWeixinJsBridgeReady', onBridgeReady);
}
} else {
onBridgeReady();
}
function onBridgeReady() {
WeixinJsBridgeReady.on('menu:share:appmessage', wx_shareFriend); // 分享朋友
WeixinJsBridgeReady.on('menu:share:timeline', wx_shareTimeline); // 分享到朋友圈
WeixinJsBridgeReady.on('menu:share:weibo', wx_shareWeibo); // 分享到微博
}
function wx_shareFriend() {
WeixinJsBridge.invoke('sendAppMessage', {
"appid": appid, "img_url": imgUrl, "img_width": '640', "img_height": '500',
"link": lineLink, "desc": descContent, "title": shareTitle
}, function(res) {
console.log(res.err_msg);
});
}
function wx_shareTimeline() {
WeixinJsBridge.invoke('sendTimeline', {
"appid": appid, "img_url": imgUrl, "img_width": '640', "img_height": '500',
"link": lineLink, "desc": descContent, "title": shareTitle
}, function(res) {
console.log(res.err_msg);
});
}
function wx_shareWeibo() {
WeixinJsBridge.invoke('sendWeibo', {
"appid": appid, "img_url": imgUrl, "img_width": '640', "img_height": '500',
"link": lineLink, "desc": descContent, "title": shareTitle
}, function(res) {
console.log(res.err_msg);
});
}
這裡的關鍵是 WeixinJsBridgeReady 事件:Bridge 物件不一定在你執行到那段程式碼時就已就緒,因此必須先判斷它是否存在,不存在時就註冊事件等待,否則容易出現「別人的頁面分享正常、我的卻沒反應」的情況。
WeixinJsBridge.call('hideOptionMenu');
WeixinJsBridge.call('hideToolbar');
WeixinJsBridge.invoke('getNetworkType', {}, function(e) {
console.log(e.err_msg);
});
WeixinJsBridge.invoke('disabledShare', {}, function(e) {
});
// true or false var flag = WeixinApi.openInWeixin();
上面這些都是基於 WeixinJSBridge 的早期用法。微信後續推出了官方的 JS-SDK,需要先在後台配置簽名權限,透過 wx.config 初始化後再呼叫 wx.ready, API 也更完整(例如 previewImage、updateAppMessageShareData、hideOptionMenu 等)。新專案建議直接採用 JS-SDK,這份清單則適合用來理解或維護較早期的程式碼。