本文主要是介绍PHP:【微信小程序】微信小程序API,微信小程序路由,微信小程序作用域,微信小程序网络通讯,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!
PHP:【微信小程序】微信小程序API,微信小程序路由,微信小程序作用域,微信小程序网络通讯
一.微信 API
- 1.什么是 API
- 小程序开发框架提供丰富的微信原生API,可以方便的调起微信提供的能力,如获取用户信息,本地存储,支付功能等
- 小程序提供的API按照功能主要分为几大类:网络、媒体、文件、数据缓存、位置、设备、界面、界面节点信息还有一些特殊的开放接口
- 2.事件监听 API
- 以 on 开头的 API 用来监听某个事件是否触发
- 这类 API 接受一个回调函数作为参数,当事件触发时会调用这个回调函数,并将相关数据以参数形式传入
- wx.onAppShow 监听小程序切前台事件
- wx.onAppHide 监听小程序切后台事件
- 3.同步API
- 以 Sync 结尾的 API 都是同步 API
- 同步 API 的执行结果可以通过函数返回值直接获取,如果执行出错会抛出异常。
- wx.getSystemInfoSync 获取系统信息
- 4.异步API
- 通常都接受一个 Object 类型的参数,这个参数都支持按需指定
编号 | 参数名 | 类型 | 必填 | 说明 |
---|
1 | success | function | 否 | 接口调用成功的回调函数 |
2 | fail | function | 否 | 接口调用失败的回调函数 |
3 | complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
4 | 其他 | Any | - | 接口定义的其他参数 |
编号 | 属性 | 类型 | 说明 |
---|
1 | errMsg | string | 错误信息,如果调用成功返回 ${apiName}:ok |
2 | errCode | number | 错误码,仅部分 API 支持,具体含义请参考对应 API 文档,成功时为 0。 |
3 | 其他 | Any | 接口返回的其他数据 |
二.路由
- 1.页面路由
- 在小程序中所有页面的路由全部由框架进行管理
- 框架以栈的形式维护了当前的所有页面
- 2.路由组件
- navigator 页面链接
编号 | 属性 | 类型 | 默认值 | 必填 | 说明 |
---|
1 | target | string | self | 否 | 在哪个目标上发生跳转,默认当前小程序 |
2 | url | string | | 否 | 当前小程序内的跳转链接 |
3 | open-type | string | navigate | 否 | 跳转方式 |
4 | delta | number | 1 | 否 | 当 open-type 为 ‘navigateBack’ 时有效,表示回退的层数 |
5 | app-id | string | | 否 | 当 target="miniProgram"时有效,要打开的小程序 |
6 | path | string | | 否 | 当 target="miniProgram"时有效,打开的页面路径,如果为空则打开首页 |
7 | extra-data | object | | 否 | 当 target="miniProgram"时有效,需要传递给目标小程序的数据,目标小程序可在 App.onLaunch(),App.onShow() 中获取到这份数据。 |
8 | version | string | release | 否 | 当 target="miniProgram"时有效,要打开的小程序版本 |
9 | hover-class | string | navigator-hover | 否 | 指定点击时的样式类,当 hover-class="none"时,没有点击态效果 |
10 | hover-stop-propagation | boolean | false | 否 | 指定是否阻止本节点的祖先节点出现点击态 |
11 | hover-start-time | number | 50 | 否 | 按住后多久出现点击态,单位毫秒 |
12 | hover-stay-time | number | 600 | 否 | 手指松开后点击态保留时间,单位毫秒 |
13 | bindsuccess | string | | 否 | 当 target="miniProgram"时有效,跳转小程序成功 |
14 | bindfail | string | | 否 | 当 target="miniProgram"时有效,跳转小程序失败 |
15 | bindcomplete | string | | 否 | 当 target="miniProgram"时有效,跳转小程序完成 |
编号 | 值 | 说明 |
---|
1 | self | 当前小程序 |
2 | miniProgram | 其它小程序 |
编号 | 值 | 说明 |
---|
1 | switchTab | 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面 |
2 | reLaunch | 关闭所有页面,打开到应用内的某个页面 |
3 | redirect | 关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面 |
4 | navigate | 保留当前页面,跳转到应用内的某个页面。但是不能跳到 tabbar 页面 |
5 | navigateBack | 关闭当前页面,返回上一页面或多级页面 |
6 | exit | 退出小程序,target="miniProgram"时生效 |
编号 | 属性 | 说明 |
---|
1 | wx.switchTab | 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面 |
2 | wx.reLaunch | 关闭所有页面,打开到应用内的某个页面 |
3 | wx.redirectTo | 关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面 |
4 | wx.navigateTo | 保留当前页面,跳转到应用内的某个页面。但是不能跳到 tabbar 页面 |
5 | wx.navigateBack | 关闭当前页面,返回上一页面或多级页面 |
编号 | 属性 | 类型 | 必填 | 说明 |
---|
1 | url | string | 是 | 需要跳转的 tabBar 页面的路径 (代码包路径)(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数。 |
2 | success | function | 否 | 接口调用成功的回调函数 |
3 | fail | function | 否 | 接口调用失败的回调函数 |
4 | complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行 |
- wx.switchTab 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面
- wx.reLaunch 关闭所有页面,打开到应用内的某个页面
- wx.redirectTo 关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面
三.变量作用域
- 2.访问app文件中的全局变量 需要声明使用 getApp()方法
- 3.局部变量
- 创建变量 var 和 let,在当前文件的任何位置都可以使用、更改
四.网络通讯
- 1.服务器域名配置
- 每个微信小程序需要事先设置通讯域名,小程序只可以跟指定的域名进行网络通信
- 服务器域名请在 「小程序后台-开发-开发设置-服务器域名」 中进行配置
- 域名只支持 https (wx.request、wx.uploadFile、wx.downloadFile) 和 wss (wx.connectSocket) 协议;
- 域名不能使用 IP 地址(小程序的局域网 IP 除外)或 localhost;
- 可以配置端口,如 https://myserver.com:8080,但是配置后只能向 https://myserver.com:8080 发起请求。如果向 https://myserver.com、https://myserver.com:9091 等 URL 请求则会失败。
- 如果不配置端口。如 https://myserver.com,那么请求的 URL 中也不能包含端口,甚至是默认的 443 端口也不可以。如果向 https://myserver.com:443 请求则会失败。
- 域名必须经过 ICP 备案
- 出于安全考虑,api.weixin.qq.com 不能被配置为服务器域名,相关 API 也不能在小程序内调用。 开发者应将 AppSecret 保存到后台服务器中,通过服务器使用 getAccessToken 接口获取 access_token,并调用相关 API
- 对于每个接口,分别可以配置最多 20 个域名
编号 | 属性 | 类型 | 默认值 | 必填 | 说明 |
---|
1 | url | string | | 是 | 开发者服务器接口地址 |
2 | data | string/object/ArrayBuffer | | 否 | 请求的参数 |
3 | header | Object | | 否 | 设置请求的 header,header 中不能设置 Referer。content-type 默认为 application/json |
4 | timeout | number | | 否 | 超时时间,单位为毫秒 |
5 | method | string | GET | 否 | HTTP 请求方法 |
6 | dataType | string | json | 否 | 返回的数据格式 |
7 | responseType | string | text | 否 | 响应的数据类型 |
8 | success | function | | 否 | 接口调用成功的回调函数 |
9 | fail | function | | 否 | 接口调用失败的回调函数 |
10 | complete | function | | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
编号 | 属性 | 类型 | 说明 |
---|
1 | data | string/Object/Arraybuffer | 开发者服务器返回的数据 |
2 | statusCode | number | 开发者服务器返回的 HTTP 状态码 |
3 | header | Object | 开发者服务器返回的 HTTP Response Header |
4 | cookies | Array. | 开发者服务器返回的 cookies,格式为字符串数组 |
这篇关于PHP:【微信小程序】微信小程序API,微信小程序路由,微信小程序作用域,微信小程序网络通讯的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!