兼容
小程序的功能不斷的增加,但是舊版本的微信客戶端並不支持新功能,所以在使用這些新能力的時候需要做兼容。
文檔會在組件,API等頁面描述中帶上各個功能所支持的版本號。
可以通過 wx.getSystemInfo 或者 wx.getSystemInfoSync 獲取到小程序的基礎庫版本號。
//getSystemInfo :獲取系統信息 getSystemInfoSync :獲取系統信息同步
也可以通過 wx.canIUse 詳情 來判斷是否可以在該基礎庫版本下直接使用對應的API或者組件
兼容方式 - 接口
對於新增的 API,可以用以下代碼來判斷是否支持用戶的手機。
//bluetooth:藍牙 adapter:適配器 modal:情態的;形式的
if (wx.openBluetoothAdapter) {
wx.openBluetoothAdapter()
} else {
// 如果希望用戶在最新版本的客戶端上體驗您的小程序,可以這樣子提示
wx.showModal({
title: '提示',
content: '當前微信版本過低,無法使用該功能,請升級到最新微信版本后重試。'
})
}
兼容方式 - 參數
對於 API 的參數或者返回值有新增的參數,可以判斷用以下代碼判斷。
wx.showModal({
success: function(res) {
if (wx.canIUse('showModal.cancel')) {
console.log(res.cancel)
}
}
})
兼容方式 - 組件
//contact:接觸;
對於組件,新增的屬性在舊版本上不會被處理,不過也不會報錯。如果特殊場景需要對舊版本做一些降級處理,可以這樣子做。
Page({
data: {
canIUse: wx.canIUse('button.open-type.contact')
}
})
<button wx:if="{{canIUse}}" open-type="contact">
客服消息
</button>
<contact-button wx:else></contact-button>