当前阅读教程:微信小程序入门教程 > API | |||||||||||||||||||||||||||||||||
阅读(22555525) 收藏 赞(5685) 分享 | |||||||||||||||||||||||||||||||||
上一篇: 模块化 | 下一篇: 视图层WXML | ||||||||||||||||||||||||||||||||
小程序开发框架提供丰富的微信原生 API,可以方便地调用微信提供的能力,如获取用户信息、本地存储、支付功能等。通常,在小程序 API 有以下几种类型:事件监听 API、同步API、异步API。 1.事件监听 API以 on 开头的 API 用来监听某个事件是否触发,如:wx.onSocketOpen、wx.onCompassChange 等。这类 API 接受一个回调函数作为参数,当事件触发时会调用这个回调函数,并将相关数据以参数形式传入。代码示例 如下: wx.onCompassChange(function (res) { console.log(res.direction) }) 2.同步 API以 Sync 结尾的 API 都是同步 API, 如 wx.setStorageSync、wx.getSystemInfoSync 等。此外,也有一些其他的同步 API,如 wx.createWorker、wx.getBackgroundAudioManager 等。同步 API 的执行结果可以通过函数返回值直接获取,如果执行出错会抛出异常。代码示例 如下: try { wx.setStorageSync('key', 'value') } catch (e) { console.error(e) } 3.异步 API大多数 API 都是异步 API,如 wx.request、wx.login 等。这类 API 接口通常都接受一个 Object 类型的参数,这个参数用于指定如何接收接口调用结果。 Object 参数说明如下:
API通常的回调函数有三个:success、fail、complete,回调函数调用时会传入一个 Object 类型参数,包含以下字段:
异步 API 的执行结果需要通过 Object 类型的参数中传入的对应回调函数获取。部分异步 API 也会有返回值,可以用来实现更丰富的功能,如 wx.request、wx.connectSockets 等。 代码示例 如下: wx.login({ success(res) { console.log(res.code) } }) |
|||||||||||||||||||||||||||||||||
上一篇: 模块化 | 下一篇: 视图层WXML |