不可否認,騰訊的產品在商業上非常成功,但官方文件卻常讓開發者叫苦——想在一大堆公眾號資料裡找到真正完整的 Web 開發文件,往往只能翻到零散的示例。就在這樣的處境下,作者寫出了 jQuery.wechat,一個提供統一 API、基於 jQuery.promise 的外掛,希望多少幫到大家。

安裝相當簡單,一行 bower 指令即可:
bower install --save jquery-wechat
不用 bower 的話,直接從 GitHub 下載解壓也一樣。載入時依序引入 jQuery 與外掛本身:
<script type="text/javascript" src="bower_components/jquery/dist/jquery.min.js"></script>
<script type="text/javascript" src="bower_components/jquery-wechat/dist/jquery-wechat.min.js"></script>
啟用只要一行:$.wechat.enable();。因為整個外掛基於 promise,你也可以串起鏈:
$.wechat.enable().done(function(){
alert('已經啟用成功');
}).fail(function(){
alert('啟用失敗');
});
考量到單頁應用(SPA)的普及,工具類的設計必須具備啟用/停用機制。啟用後,所有操作若尚未就緒會自動排隊,一旦啟用成功便依序執行;若失敗則永不執行。
隱藏/顯示菜單與底部工具欄:
$.wechat.hideMenu();
$.wechat.showMenu();
$.wechat.hideToolbar();
$.wechat.showToolbar();
打開掃碼與圖片預覽:
$.wechat.scanQRcode();
$.wechat.preview({
current: 'https://xxx/img/pic001.jpg',
urls: [
'https://xxx/img/pic001.jpg',
'https://xxx/img/pic002.jpg',
'https://xxx/img/pic003.jpg'
]
});
取得網路狀態:
$.wechat.getNetworkType().done(function(response) {
$('#network').text(response.split(':')[1]);
});
response 可能的格式有:network_type:wifi(無線網路)、network_type:edge(非 wifi,含 3G/2G)、network_type:fail(網路斷線)、network_type:wwan(2G 或 3G)。
當別人分享出來的消息有精美縮圖、標題與描述,而你卻只有一張空白藍圖時,就靠這段來扳回一城:
$.wechat.setShareOption({
appid: 'xxxx', //小標 appid
img_width: '60',
img_height: '60',
img_url: window.location.toString() + 'img/demo.jpg', //縮略圖
title: 'DEMO', //標題
desc: 'The description is set from $.wechat.setShareOption', //描述
link: function() {
return window.location.toString(); //點擊後打開的連結
},
callback: function(response) {
alert(response); //分享後的回呼
}
});
設定後會同時影響「發送給朋友、分享到朋友圈、分享到微博、發送郵件」四項功能,效果如下圖:

此外還有 $.wechat.closeWindow() 關閉當前頁,以及 $.wechat.destroy() 停用整個機制。整體而言,這套外掛把繁瑣的微信 JS 介面包裝成直覺的鏈式呼叫,開發體驗相當順手。