微信小程序 兼容

2022-04-27 14:58 更新

小程序的功能不斷的增加,但是舊版本的微信客戶端并不支持新功能,所以在使用這些新能力的時候需要做兼容。

文檔會在組件,API等頁面描述中帶上各個功能所支持的版本號。

可以通過wx.getSystemInfo或者wx.getSystemInfoSync獲取到小程序的基礎(chǔ)庫版本號。

也可以通過wx.canIUse 詳情 來判斷是否可以在該基礎(chǔ)庫版本下直接使用對應(yīng)的API或者組件

兼容方式 - 接口

對于新增的 API,可以用以下代碼來判斷是否支持用戶的手機(jī)。

if (wx.openBluetoothAdapter) {
  wx.openBluetoothAdapter()
} else {
  // 如果希望用戶在最新版本的客戶端上體驗?zāi)男〕绦颍梢赃@樣子提示
  wx.showModal({
    title: '提示',
    content: '當(dāng)前微信版本過低,無法使用該功能,請升級到最新微信版本后重試。'
  })
}

兼容方式 - 參數(shù)

對于 API 的參數(shù)或者返回值有新增的參數(shù),可以判斷用以下代碼判斷。

wx.showModal({
  success: function(res) {
    if (wx.canIUse('showModal.cancel')) {
      console.log(res.cancel)
    }
  }
})

兼容方式 - 組件

對于組件,新增的屬性在舊版本上不會被處理,不過也不會報錯。如果特殊場景需要對舊版本做一些降級處理,可以這樣子做。

Page({
  data: {
    canIUse: wx.canIUse('button.open-type.contact')
  }
})
<button wx:if="{{canIUse}}" open-type="contact"> 客服消息 </button>
<contact-button wx:else></contact-button>
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號