简介: uni-app是一个使用Vue.js开发所有前端应用的框架,开发者编写一套代码,可以发布到IOS、Android、Web(响应式)、以及各种小程序、快应用等多个平台。
uniapp真正做到一套代码多端发行,支持原生代码混写和原生sdk集成。
运行体验更好。组件、api与微信小程序一致,兼容 Weex 原生渲染。
通用技术栈,学习成本更低。Vue的语法,微信小程序的api,对于前端开发人员来说更容易上手。
开放生态,组件更丰富。支持通过npm安装第三方包;支持微信小程序自定义组件及sdk;兼容 mpvue 组件及项目;app端支持与原生混合编码;
微信小程序有自带的api接口,wx.request();
不会跨域
跨域问题的出现是因为浏览器在进行请求时存在同源策略, 但是微信小程序不受同源策略的影响.所以不存在跨域问题
wx.request({url: 'https://showme.myhope365.com/api/cms/article/open/list',method: "POST",data: {pageNum: 1,pageSize: 10},header: {"content-type": "application/x-www-form-urlencoded"},success: res => {console.log(res.data.rows)}})
wx.request——参数说明
url 开发者服务器接口地址。注意这里需要配置域名
data 请求的参数
header 设置请求的 header,header 中不能设置 Referer,默认header[‘content-type’] = ‘application/json’
method(需大写)有效值:OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataType json 回包的内容格式,如果设为json,会尝试对返回的数据做一次 JSON解析
success 收到开发者服务成功返回的回调函数。
fail 接口调用失败的回调函数
complete 接口调用结束的回调函数(调用成功、失败都会执行)
- 引用数据
{{}} 小程序中任何需要获取数据的地方都需要用{{}},包括标签内的属性
WXML 提供两种文件引用方式import和include。
import 需要注意的是 import 有作用域的概念,即只会 import 目标文件中定义的 template,而不会 import 目标文件中 import 的 template,简言之就是 import 不具有递归的特性。
include,可以将目标文件中除了 外的整个代码引入,相当于是拷贝到 include 位置。
- 逻辑渲染 wx:if wx:elif wx:else hidden
hidden 条件渲染
wx:if在不满足条件的时候会删除掉对应的DOM
hidden属性则是通过display属性设置为none来进行条件渲染
- 列表渲染 wx:for wx:for-item wx:for-index wx:key,使用 wx:for-item 指定数组当前元素的变量名,使用 wx:for-index 指定数组当前下标的变量名。
wx:key 的值以两种形式提供:
字符串,代表在 for 循环的 array 中 item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。
保留关键字 this 代表在 for 循环中的 item 本身,这种表示需要 item 本身是一个唯一的字符串或者数字。当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率。
{array}}" wx:for-index="index" wx:for-item="itemName.id">{{index.cra}}
- 驱动视图 this.setData({})
- 事件绑定 bind
优势
不足
直观的说小程序中没有DOM和BOM对象,也无法对npm包进行管理
浏览器中JS
Node中的JS
NPM 是包管理系统、NPM是目前最大的开原库生态系统,通过各种NPM扩展包快速的实践一些功能。
Native 就是原生的模块,通过这个模块来使用JavaScript语言本身不具有的一些能力(native方法简单的讲,即Java调用非Java代码的接口)。
小程序中的JS
浏览器中渲染是单线程的;
而在小程序中的运行环境分成渲染层和逻辑层, WXML 模板和 WXSS 样式工作在渲染层,JS 脚本工作在逻辑层。
WXML模板使用 view 标签,其子节点用 {{ }} 的语法绑定一个 msg 的变量。
在 JS 脚本使用 this.setData 方法把 msg 字段设置成 “Hello World”。
小程序的渲染层和逻辑层分别由2个线程管理:
渲染层的界面使用了WebView 进行渲染;
逻辑层采用JsCore线程运行JS脚本。
一个小程序存在多个界面,所以渲染层存在多个WebView线程,这两个线程的通信会经由微信客户端(Native)做中转。
逻辑层发送网络请求也经由Native转发。
小程序中的生命周期函数,分为 应用生命周期函数 和 页面生命周期函数 。
应用生命周期函数
onLaunch 函数的参数也可以使用 wx.getLaunchOptionsSync 获取;
onShow 也可以使用 wx.onAppShow 绑定监听;
onHide 也可以使用 wx.onAppHide 绑定监听;
App.js是小程序入口文件,所以在App.js中调用应用生命周期函数:
微信小程序官网
App({onLaunch: function () {// 当小程序初始化完成时,会触发 onLaunch(全局只触发一次)},onShow: function (options) {// 当小程序启动,或从后台进入前台显示,会触发 onShow },onHide: function () {// 当小程序从前台进入后台,会触发 onHide},onError: function (msg) {// 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息}
})
页面生命周期函数有:
微信小程序官网
还有一些特殊的生命周期,它们并非与组件有很强的关联,但有时组件需要获知,以便组件内部处理。这样的生命周期称为“组件所在页面的生命周期”,在 pageLifetimes 定义段中定义。其中可用的生命周期包括:
生命周期 | 参数 | 描述 |
---|---|---|
show | 无 | 组件所在的页面被展示时执行 |
hide | 无 | 组件所在的页面被隐藏时执行 |
resize | Object Size | 组件所在的页面尺寸变化时执行 |
事件定义 bind开头
在小程序中绑定事件可以以bind开头然后跟上事件的类型,如bindtap绑定一个点击事件,对应的值是一个字符串,需要在page构造器中定义同名函数,每次触发事件之后就会执行对应函数的内容。
阻止事件冒泡 catch开头
在小程序中除了通过bind之外,还可以通过catch进行事件绑定,通过catch绑定的事件不会触发事件冒泡。
事件捕获 capture-bind开头
事件的触发分为两个阶段,首先是捕获阶段,其次是冒泡阶段。默认情况下事件都是在冒泡阶段触发。如果希望事件可以在捕获阶段触发,可以通过capture-bind进行事件绑定。
事件传参 data-
在小程序中进行事件传参不能像传统的Web项目中一样,在括号里写参数。在小程序中需要在标签上通过data-方式定义事件所需的参数。
关于事件对象其他属性
type 事件类型
timeStamp 页面打开到触发事件所经过的毫秒数
target 触发事件的组件的一些属性值集合
currentTarget 当前组件的一些属性值集合
detail 额外的信息
touches 触摸事件,当前停留在屏幕中的触摸点信息的数组
changedTouches 触摸事件,当前变化的触摸点信息的数组
这里需要注意的是target和currentTarget的区别,currentTarget为当前事件所绑定的组件,而target则是触发该事件的源头组件。
点击事件 每个事件回调触发时,都会收到一个事件对象,通过这个对象可以获取路由传递的参数。handleTap(e){console.log("执行了点击事件");// 通过currentTarget中的dataset属性可以获取时间参数console.log(e.currentTarget.dataset.msg);//我是事件的参数
}
WXSS和CSS类似,不过在CSS的基础上做了一些补充和修改。
最常用的两个页面的跳转和传参方式:1.wx.navigateTo 2.navigator标签
保留当前页面,只能打开非 tabBar 页面。
跳转到新页面
wx.navigateTo({url: `/pages/details?id=${xxx}`
});
其他方式:
wx.switchTab() 不能进行页面传参
用来 跳转至tabBar页面,并关闭其他所有非 tabBar 页面
wx.redirectTo() 关闭卸载当前页面,只能打开非 tabBar 页面。
wx.navigateTo() 一样,都 跳转至非tabBar页面,但会关闭当前页面
wx.reLaunch() 关闭卸载所有页面,可以打开任意页面。
wx.navigateBack() 用来返回上一页面或多级页面,并关闭当前页面。
返回前面的页面,可以指定返回多少页,如果用过redirectTo,那么被关闭的页面将不能返回
wx.navigateBack({delta: 2 //返回的页面数,如果 delta 大于现有页面数,则返回到首页。})
接收参数
路由跳转传参可以通过?的方式拼接参数。跳转到指定界面之后,可以在该页面的onLoad方法中的options参数(本身是个对象)拿到路由跳转的参数。
小程序提供了读写本地数据缓存的接口,通过wx.setStorage写数据到缓存,在小程序中几乎所有接口都是异步的,这里存储数据也是一个异步操作,如果希望进行同步存储需要调用wx.setStorageSync。
异步存储👲
wx.setStorage({data: {name:"天亮教育",age:4},//需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。key: 'list',//本地缓存中指定的 key})
同步存储👲
wx.setStorageSync('list1', {name:"尚云科技",age:5})
同步读取
const list = wx.getStorageSync('list')
缓存的限制和隔离
封装前
wx.request({url: 'xxx',data: {a: '',b: ''},header: {'content-type': 'application/json' // 默认值},success(res) {console.log(res.data)},fail(err){console.log(err) }
})
封装后
const baseUrl = "123456.com"
function request(method, url, dataObj) {return new Promise(function(resolve, reject) {let header = {'content-type': 'application/json',};wx.request({url: baseURL + url,method: method,data: dataObj.data,header: dataObj.header||header,success(res) {//请求成功if (res.code == 0) {resolve(res);} else {//其他异常reject('运行时错误,请稍后再试');}},fail(err) {//请求失败reject(err)}})})
}
(上面的方法)由于每个页面单独请求效率低下且不便于维护,所以需要封装 wx.request 接口。
通常以返回 promise 对象的形式进行请求的封装:
下面的时候封装后的,可以直接通过 .then() 方法使用
封装的优点
作用:
在JS文件中的data中动态操控数据:使用 this.setData方法修改视图层data中的数据;
在wxml文件通过{{}}将数据绑定,即可在页面中显示
注意:
{{text}} // page.jsPage({data: {text: '天黑教育',},onLoad(){console.log(this.data.text)//天黑教育this.setDatta.text = '50'console.log(this.data.text)//50}})
原因
通常后端采用的登录鉴权方式是通过cookie的方式进行的鉴权,即登录成功之后,后端会给我们cookie上增加一个JSESSIONID,这个JESSIONID就标识了当前登录用户的身份。
在浏览器中,我们每次发送请求都会携带cookie,所以说在浏览器中我们登录成功之后就可以直接调用登录之后才能访问的接口。但是在小程序端,小程序默认不会帮我们在发送请求的时候带上cookie,这个时候就需要我们手动添加请求cookie了。
解决方法
1. 在登录成功之后,我们获取到后台返回的cookie中的JESSIONID并进行记录。2. 在每次发送请求的时候,在请求头中添加上cookie属性。
function request(options) {// 请求拦截器// ...// 1. 加一些统一的参数,或者配置if (!options.url.startsWith("https://") && !options.url.startsWith("http://")) {//地址仅供参考options.url = "https://showme.myhope365.com" + options.url}// 默认的请求头let header = {// 默认的格式
"content-type": "application/x-www-form-urlencoded",// 加上统一的cookie"cookie": wx.getStorageSync("cookie") || ""};if (options.header) {header = {...header,...options.header}}return new Promise((reslove, reject) => {// 调用接口wx.request({// 默认的配置// 加载传入的配置...options,header,success(res) {// 响应拦截器,所有接口获取数据之前,都会先执行这里// 1. 统一的错误处理if (res.statusCode != 200) {wx.showToast({title: '服务器异常,请联系管理员',})}reslove(res)},fail(err) {reject(err)}})})}
获取网络状态(2G/3G/4G/5G/WIFI…)
Page({// 点击“预览文档”的按钮,触发tap回调tap: function() {wx.getNetworkType({success: function(res) {// networkType字段的有效值:// wifi/2g/3g/4g/5g/unknown(Android下不常见的网络类型)/none(无网络)if (res.networkType == 'wifi') {// 从网络上下载文档wx.downloadFile({url:' https://lark-temp.oss-cn-hangzhou.aliyuncs.com/__temp/464110/docx/bb5d8e7d-97bc-406b-be94-ca2b4724c0e6.docx?OSSAccessKeyId=LTAI4GKnqTWmz2X8mzA1Sjbv&Expires=1644944885&Signature=qUYOtNWZOaopjkEFbcKpvgmn%2B1U%3D',success: function (res) {// 下载成功之后进行预览文档wx.openDocument({filePath: res.tempFilePath })}})} else {wx.showToast({ title: '当前为非Wifi环境' })}}})}
})
扫码能力
Page({// 点击“扫码订餐”的按钮,触发tapScan回调tapScan: function() {// 调用wx.login获取微信登录凭证wx.scanCode({success: function(res) {var num = res.result // 获取到的num就是餐桌的编号}})}
})
分享能力(分享朋友圈-聊天页面)
Page({
onShareAppMessage(){ // 我们要记录转发的记录 return { // 分享的标题 title:'网友热议', // 分享的封面, 默认为当前页面的截图 imageUrl:"/assets/icon/index.png", // 点击分享跳转的路径,默认是当前路径,也可以自定义配置,添加额外的跳转参数 path:"/pages/index/index?userId=10&entry=share"}
}, // 省略了别的属性 ...})
wx.canIUse(string schema)
判断小程序的API、回调、参数、组件等是否在当前版本可用
wx.getSystemInfoSync() | wx.getSystemInfo()
获取系统信息
wx.getUserProfile(Object object)
获取用户信息。页面产生点击事件(例如 button 上 bindtap 的回调中)后才可调用,每次请求都会弹出授权窗口,用户同意后返回 userInfo。该接口用于替换 wx.getUserInfo
区别
父传子 properties接收
子传父 triggerEvent方法
父传子的不同点是:微信小程序在子组件中接受父组件传 用 propertites 进行接收,而不是 props
properties: {msg:{// type 要接收的数据的类型type:String,// value 默认值value:""},},
子传父的不同点是:微信小程序在子组件中使用 triggerEvent 抛出自定义事件名,而不是 this.$emit()
methods: {sendData() {console.log(this.data.msg)this.triggerEvent('eventName', '要传递的参数')}}
behaviors 是用于组件间代码共享的特性,类似于一些编程语言中的 mixins 或 traits。
每个 behavior 可以包含一组属性、数据、生命周期函数和方法。组件引用它时,它的属性、数据和方法会被合并到组件中,生命周期函数也会在对应时机被调用。 每个组件可以引用多个 behavior ,behavior 也可以引用其它 behavior 。
组件引用时,在 behaviors 定义段中将它们逐个列出即可。
// my-component.js
var myBehavior = require('my-behavior')
Component({behaviors: [myBehavior],properties: {myProperty: {type: String}},data: {myData: 'my-component-data'},created: function () {console.log('[my-component] created')},attached: function () { console.log('[my-component] attached')},ready: function () {console.log('[my-component] ready')},methods: {myMethod: function () {console.log('[my-component] log by myMethod')},}
})
包体积优化
分包加载(优先采用,大幅降低主包体积)。
图片优化(1.使用tinypng压缩图片素材; 2.服务器端支持,可采用webp格式)。
组件化开发(易维护)。
减少文件个数及冗余数据。
请求优化
首次渲染优化
思路:把屏幕分为左右两个容器,根据容器的高度决定下一个元素应该放在哪个容器内(高度相对较低的容器)。
// 处理数据initList(list) {this.data.finish = false// 临界值if (list.length == 0) {this.data.finish = truereturn}let item = list.shift()wx.getImageInfo({src: item.coverImgUrl,success: (res) => {if (this.data.leftHeight <= this.data.rightHeight) {// 默认从左往右渲this.data.leftList.push(item)this.data.leftHeight += res.height / res.width} else {this.data.rightList.push(item)this.data.rightHeight += res.height / res.width}this.setData({leftList: this.data.leftList,rightList: this.data.rightList,})},complete: () => {this.initList(list)}})
I guess it comes down to a simple choice: get busy living or get busy dying.
该做个简单的选择了:要么忙着活,要么忙着死。