小程序 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