萬盛學電腦網

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

微信網頁開發常用 JS 介面整理(WeixinJSBridge / JSSDK)

前置說明

早期微信內頁面使用 WeixinJSBridge 私有介面,現已全面遷移至官方 微信 JSSDK(wx.config + wx.ready)。本文整理常用場景對應的新舊寫法,建議新專案直接使用 JSSDK。

1. 圖片預覽(Image Preview)

JSSDK 寫法(推薦)

wx.ready(() => {
  document.querySelectorAll('.gallery img').forEach(img => {
    img.addEventListener('click', () => {
      wx.previewImage({
        current: img.src,           // 當前顯示圖片連結
        urls: [...document.querySelectorAll('.gallery img')].map(i => i.src) // 所有圖片連結
      });
    });
  });
});

2. 關閉視窗

// JSSDK
wx.closeWindow();

// 舊版(僅供參考)
WeixinJSBridge.invoke('closeWindow', {}, (res) => { /* ... */ });

3. 分享介面(自定義分享內容)

需先完成 wx.config 驗證,並在 wx.ready 中註冊:

wx.ready(() => {
  const shareData = {
    title: '自定義標題',
    desc: '自定義描述',
    link: location.href,
    imgUrl: 'https://example.com/share-icon.png'
  };

  // 分享給朋友
  wx.updateAppMessageShareData(shareData);
  wx.onMenuShareAppMessage(shareData);

  // 分享到朋友圈
  wx.updateTimelineShareData(shareData);
  wx.onMenuShareTimeline(shareData);
});

注意:wx.onMenuShareAppMessage 等舊版介面已標記棄用,新專案請使用 updateAppMessageShareData / updateTimelineShareData。

4. 隱藏右上角選單 / 底部導航列

wx.ready(() => {
  wx.hideOptionMenu();   // 隱藏右上角「...」選單
  wx.hideToolbar();      // 隱藏底部工具列(iOS 已棄用,Android 部分版本仍生效)
});

5. 獲取網路狀態

wx.getNetworkType({
  success: (res) => {
    console.log(res.networkType); // wifi / 2g / 3g / 4g / 5g / unknown
  }
});

6. 禁止分享

wx.ready(() => {
  wx.hideMenuItems({ menuList: ['menuItem:share:appMessage', 'menuItem:share:timeline'] });
});

7. 判斷是否在微信內建瀏覽器

function isWeixin() {
  const ua = navigator.userAgent.toLowerCase();
  return ua.match(/MicroMessenger/i) === 'micromessenger';
}

// 或使用 JSSDK ready 狀態
wx.ready(() => { /* 在微信中 */ });
wx.error(() => { /* 不在微信或配置失敗 */ });

8. 掃碼 / 選圖 / 拍照 / 語音等媒體介面

// 掃碼
wx.scanQRCode({
  needResult: 1,
  scanType: ['qrCode', 'barCode'],
  success: (res) => { console.log(res.resultStr); }
});

// 選圖/拍照
wx.chooseImage({
  count: 9,
  sizeType: ['original', 'compressed'],
  sourceType: ['album', 'camera'],
  success: (res) => { console.log(res.localIds); } // 返回本地 ID,需上傳至微信服務器獲取 serverId
});

// 上傳圖片
wx.uploadImage({
  localId: localIds[0],
  isShowProgressTips: 1,
  success: (res) => { console.log(res.serverId); }
});

JSSDK 接入檢查清單

  1. 後端簽名:依據 url、noncestr、timestamp、jsapi_ticket 計算 signature。
  2. 前端配置:wx.config({ debug: false, appId, timestamp, nonceStr, signature, jsApiList: [...] })。
  3. 安全域名:在公眾號後台設定「JS 介面安全域名」(不帶協議與路徑)。
  4. HTTPS:生產環境必須 HTTPS,localhost 開發可用內網穿透(ngrok / frp)映射 HTTPS。

常見坑點

  • 簽名失效:URL 必須與當前頁面完全一致(含 query string、hash),單頁應用路由切換需重新簽名。
  • 分享不生效:iOS 微信 7.0+ 僅支援 updateAppMessageShareData,舊版 onMenuShareAppMessage 失效。
  • 圖片上傳失敗:chooseImage 回傳 localId 必須先 uploadImage 取得 serverId,再傳給後端下載。
copyright © 萬盛學電腦網 all rights reserved