PHP:【微信小程序】微信小程序API,微信小程序路由,微信小程序作用域,微信小程序网络通讯

2021/10/14 12:14:17

本文主要是介绍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 类型的参数,这个参数都支持按需指定
编号参数名类型必填说明
1successfunction接口调用成功的回调函数
2failfunction接口调用失败的回调函数
3completefunction接口调用结束的回调函数(调用成功、失败都会执行)
4其他Any-接口定义的其他参数
  • wx.getSystemInfo 获取系统信息

  • 回调函数的参数,success,fail,complete 函数调用时会传入一个 Object 类型参数

编号属性类型说明
1errMsgstring错误信息,如果调用成功返回 ${apiName}:ok
2errCodenumber错误码,仅部分 API 支持,具体含义请参考对应 API 文档,成功时为 0。
3其他Any接口返回的其他数据

二.路由

  • 1.页面路由
  • 在小程序中所有页面的路由全部由框架进行管理
  • 框架以栈的形式维护了当前的所有页面
  • 2.路由组件
  • navigator 页面链接
编号属性类型默认值必填说明
1targetstringself在哪个目标上发生跳转,默认当前小程序
2urlstring当前小程序内的跳转链接
3open-typestringnavigate跳转方式
4deltanumber1当 open-type 为 ‘navigateBack’ 时有效,表示回退的层数
5app-idstring当 target="miniProgram"时有效,要打开的小程序
6pathstring当 target="miniProgram"时有效,打开的页面路径,如果为空则打开首页
7extra-dataobject当 target="miniProgram"时有效,需要传递给目标小程序的数据,目标小程序可在 App.onLaunch(),App.onShow() 中获取到这份数据。
8versionstringrelease当 target="miniProgram"时有效,要打开的小程序版本
9hover-classstringnavigator-hover指定点击时的样式类,当 hover-class="none"时,没有点击态效果
10hover-stop-propagationbooleanfalse指定是否阻止本节点的祖先节点出现点击态
11hover-start-timenumber50按住后多久出现点击态,单位毫秒
12hover-stay-timenumber600手指松开后点击态保留时间,单位毫秒
13bindsuccessstring当 target="miniProgram"时有效,跳转小程序成功
14bindfailstring当 target="miniProgram"时有效,跳转小程序失败
15bindcompletestring当 target="miniProgram"时有效,跳转小程序完成
  • target 的合法值
编号说明
1self当前小程序
2miniProgram其它小程序
  • open-type 的合法值
编号说明
1switchTab跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面
2reLaunch关闭所有页面,打开到应用内的某个页面
3redirect关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面
4navigate保留当前页面,跳转到应用内的某个页面。但是不能跳到 tabbar 页面
5navigateBack关闭当前页面,返回上一页面或多级页面
6exit退出小程序,target="miniProgram"时生效

  • 3.路由 api
编号属性说明
1wx.switchTab跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面
2wx.reLaunch关闭所有页面,打开到应用内的某个页面
3wx.redirectTo关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面
4wx.navigateTo保留当前页面,跳转到应用内的某个页面。但是不能跳到 tabbar 页面
5wx.navigateBack关闭当前页面,返回上一页面或多级页面
编号属性类型必填说明
1urlstring需要跳转的 tabBar 页面的路径 (代码包路径)(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数。
2successfunction接口调用成功的回调函数
3failfunction接口调用失败的回调函数
4completefunction接口调用结束的回调函数(调用成功、失败都会执行
  • wx.switchTab 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面

  • wx.reLaunch 关闭所有页面,打开到应用内的某个页面

  • wx.redirectTo 关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面

三.变量作用域

  • 1.全局变量:app.js 中的参数

  • 2.访问app文件中的全局变量 需要声明使用 getApp()方法

  • 3.局部变量
  • 创建变量 var 和 let,在当前文件的任何位置都可以使用、更改

  • 4.私有变量
  • 声明在js方法中的变量

四.网络通讯

  • 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 个域名

  • 2.API wx.request
    • 发起 HTTPS 网络请求
编号属性类型默认值必填说明
1urlstring开发者服务器接口地址
2datastring/object/ArrayBuffer请求的参数
3headerObject设置请求的 header,header 中不能设置 Referer。content-type 默认为 application/json
4timeoutnumber超时时间,单位为毫秒
5methodstringGETHTTP 请求方法
6dataTypestringjson返回的数据格式
7responseTypestringtext响应的数据类型
8successfunction接口调用成功的回调函数
9failfunction接口调用失败的回调函数
10completefunction接口调用结束的回调函数(调用成功、失败都会执行)
  • 返回值:回包
编号属性类型说明
1datastring/Object/Arraybuffer开发者服务器返回的数据
2statusCodenumber开发者服务器返回的 HTTP 状态码
3headerObject开发者服务器返回的 HTTP Response Header
4cookiesArray.开发者服务器返回的 cookies,格式为字符串数组



这篇关于PHP:【微信小程序】微信小程序API,微信小程序路由,微信小程序作用域,微信小程序网络通讯的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!


扫一扫关注最新编程教程