萬盛學電腦網

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

jQuery.wechat:微信網頁開發統一 API 外掛使用指南

專案背景

微信 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>

核心 API

啟用/停用(生命週期管理)


// 啟用,回傳 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() 完成前的呼叫進入佇列,就緒後順序執行。
  • Promise 統一:所有非同步操作回傳 $.Deferred 相容物件,支援 .done/.fail/.always。
  • WeixinJSBridgeReady 封裝:自動處理微信內建橋接就緒事件。
  • 錯誤標準化:統一錯誤碼與訊息格式。

適用場景與遷移建議

  • 維護舊專案、jQuery 技術棧、需快速整合微信功能。
  • 新專案建議:直接使用官方 weixin-js-sdk NPM 套件 + axios + async/await 手動封裝,或使用 wechat-jssdk 等現代封裝庫。
copyright © 萬盛學電腦網 all rights reserved