小程序API入门
1.1 API类型
- 事件监听API。以on结尾的API用来监听某个事件是否触发。可承受一个回调函数作为参数。
- 同步API。以Sync结尾的API都是同步API。同步API执行后果可通过返回值间接获取,如果执行出错会报错
异步API。大多数API都是异步API。这类接口通常都承受Object类型的参数
异步API 语法格局:
api名称({ api内容 })
api内容包含三局部回调函数:success、fail、complete
- API运行程序:
例:
wx.login({ success(res){ // API调用胜利执行的代码}, fail(res){ // API调用失败执行的代码}, complete(res){ // API调用结束执行的代码}})
这里的res
参数为Object类型参数,蕴含
errMsg
: string类型,错误信息,如果调用胜利返回okerrCode
: number类型,错误码,局部API反对,胜利返回0
接口返回的其余数据。
1.2 页面路由
wx.reLauch()
:敞开所有页面(其余页面都将被卸载),关上到利用的某个页面(该页面从新加载)。wx.redictTo()
:敞开(卸载)以后页面,跳转到某个利用内的页面。wx.navigateTo()
:保留(不卸载)以后页面,跳转到某个利用内的页面。wx.navigateBack()
:敞开以后页面,返回上一页面,或多级页面。
再次揭示: API内无奈应用this,须要在调用API之前保留this进行应用。如: var that = this
1.3 用户受权
checkUserInfo: function(){ // 获取小程序以后参数的API wx.getSetting({ success(res){ // 查看有用户是否曾经受权 if(res.authSetting["scope.userInfo"]){ // 获取用户信息 wx.getUserInfo({ success(res2){ console.log(res2.userInfo) } }) } } }) }
userInfo
包含以下字段:
- nickName :昵称
- avatarUrl: 用户头像图片的URL
- gender
- coutry
- province
- city
- language