wx.canIUse(String)
注意:此接口从基础库 1.1.1 版本开始支持。
判断小程序的API,回调,参数,组件等是否在当前版本可用。
String参数说明: 使用${API}.${method}.${param}.${options}或者${component}.${attribute}.${option}方式来调用,例如:
${API} 代表 API 名字
${method} 代表调用方式,有效值为return, success, object, callback
${param} 代表参数或者返回值
${options} 代表参数的可选值
${component} 代表组件名字
${attribute} 代表组件属性
${option} 代表组件属性的可选值
例子:
wx.canIUse('openBluetoothAdapter') wx.canIUse('getSystemInfoSync.return.screenWidth') wx.canIUse('getSystemInfo.success.screenWidth') wx.canIUse('showToast.object.image') wx.canIUse('onCompassChange.callback.direction') wx.canIUse('request.object.method.GET') wx.canIUse('live-player') wx.canIUse('text.selectable') wx.canIUse('button.open-type.contact')
应用示例:
在获取用户信息时,小程序升级后的版本需要用户手动点击按钮确认,并且使用button按钮open-type="getUserInfo"属性来获取,此时我们就可以做一个判断,来测试getUserInfo是否可用:
js中代码:
canIUse: wx.canIUse('button.open-type.getUserInfo')
wxml中代码:
<button wx:if="{{canIUse}}" open-type="getUserInfo" bindgetuserinfo="getUserInfo">获取头像昵称</button>