微信 JSSDK 官方文檔分散、介面不一致、Promise 化程度低。jQuery.wechat 封裝統一 API、基於 jQuery Deferred/Promise、支援啟用/停用生命週期、排隊機制。
# Bower (舊)
bower install --save jquery-wechat
# npm / yarn
npm install jquery-wechat
# 或直接下載 dist/jquery-wechat.min.js
// HTML 引入
<script src="jquery.min.js"></script>
<script src="jquery-wechat.min.js"></script>
// 啟用,回傳 Promise
$.wechat.enable().done(function() {
console.log('JSSDK 就緒');
}).fail(function(err) {
console.error('初始化失敗:', err);
});
// 停用(SPA 路由切換、銷毀頁面時呼叫)
$.wechat.destroy();
$.wechat.hideMenu(); // 隱藏右上角選單
$.wechat.showMenu(); // 顯示選單
$.wechat.hideToolbar(); // 隱藏底部工具列
$.wechat.showToolbar(); // 顯示工具列
$.wechat.closeWindow(); // 關閉當前 Webview 視窗
// 掃碼
$.wechat.scanQRcode().done(function(res) {
console.log('掃碼結果:', res.resultStr);
});
// 圖片預覽
$.wechat.preview({
current: 'https://example.com/img/1.jpg', // 當前顯示
urls: [
'https://example.com/img/1.jpg',
'https://example.com/img/2.jpg',
'https://example.com/img/3.jpg'
]
}).done(function() { console.log('預覽關閉'); });
// 網路狀態
$.wechat.getNetworkType().done(function(res) {
// res.network_type: wifi / 2g / 3g / 4g / fail
$('#net-status').text(res.network_type);
});
$.wechat.setShareOption({
appid: 'wx1234567890abcdef', // 小程序 AppID(可選)
img_url: 'https://example.com/share.jpg', // 縮略圖 (300x300 建議)
img_width: '300',
img_height: '300',
title: '自訂分享標題',
desc: '自訂分享描述內容',
link: function() { return location.href; }, // 動態連結
callback: function(res) {
// res.err_msg: 'send_app_msg:ok' / 'share_timeline:cancel' 等
if (res.err_msg.indexOf('ok') > -1) {
trackEvent('share_success');
}
}
});
影響四大入口:傳送給朋友、分享到朋友圈、分享到微博、發送郵件。
enable() 完成前的呼叫進入佇列,就緒後順序執行。$.Deferred 相容物件,支援 .done/.fail/.always。weixin-js-sdk NPM 套件 + axios + async/await 手動封裝,或使用 wechat-jssdk 等現代封裝庫。