微信小程序视图与逻辑(页面导航页面事件生命周期WXS脚本)
Posted Sco_Jing1031
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了微信小程序视图与逻辑(页面导航页面事件生命周期WXS脚本)相关的知识,希望对你有一定的参考价值。
欢迎学习交流!!!
持续更新中…
文章目录
1. 页面导航
页面导航指页面之间的相互跳转,浏览器中实现页面导航的方式有两种:<a>
链接、location.href。而小程序中实现页面导航也有两种方式:
-
声明式导航:
- 在页面上声明一个<navigator>导航组件 - 通过点击<navigator>组件实现页面跳转
-
编程式导航:
- 调用小程序的导航API,实现页面的跳转
声明式导航
导航到tabBar页面:
在使用 组件跳转到指定的 tabBar 页面时,需要指定 url 属性和 open-type 属性,其中:
- url 表示要跳转的页面的地址,必须以
/
开头 - open-type 表示跳转的方式,必须为
switchTab
<navigator url="/pages/message/message" open-type="switchTab">导航到消息页面</navogator>
导航到非tabBar页面:
在使用 组件跳转到普通的非 tabBar 页面时,需要指定 url 属性和 open-type 属性,其中:
- url 表示要跳转的页面的地址,必须以
/
开头 - open-type 表示跳转的方式,必须为
navigate
open-type="navigate"
属性可以省略
后退导航:
如果要后退到上一页面或多级页面,则需要指定 open-type 属性和 delta 属性,其中:
- open-type 的值必须是
navigateBack
,表示要进行后退导航 - delta 的值必须是数字,表示要后退的层级
- 如果只是后退到上一页,则可以省略delta属性,因为其默认值就是1
<navigator open-type="navigateBack" delta='1'>返回上一页</navogator>
编程式导航
导航到tabBar页面:
调用 wx.switchTab(Object object)
方法,即可跳转到tabBar页面。其中Object参数对象的属性如下:
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转的tabBar页面的路径,路径后不能带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
//页面结构
<button bindtap="gotoMessage">跳转到消息页面</button>
//通过编程式导航,跳转到message页面
gotoMessage()
wx.switchTab(
url: '/pages/message/message'
)
导航到非tabBar页面:
调用 wx.navigateTo(Object object)
方法,其中Object参数对象的属性列表如下:
属性 | 类型 | 是否必选 | 说明 |
---|---|---|---|
url | string | 是 | 需要跳转到的非tabBar页面的路径,路径后可以带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
后退导航:
调用 wx.navigateBack(Object object)
方法,可以返回上一页面或多级页面。其中Object参数对象可选的属性列表如下:
属性 | 类型 | 默认值 | 是否必选 | 说明 |
---|---|---|---|---|
delta | number | 1 | 否 | 返回的页面数,如果delta大于现有页面数,则返回到首页 |
success | function | - | 否 | 接口调用成功的回调函数 |
fail | function | - | 否 | 接口调用失败的回调函数 |
complete | function | - | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
导航传参
navigator组件和调用 wx.navigateTo(Object object)
方法时,url路径后可携带参数:
- 参数与路径之间使用
?
分隔 - 参数键与参数值用
=
相连 - 不同参数用
&
分隔
在onLoading中接收导航参数:
通过声明式导航传参或编程式导航传参所携带的参数,可以直接在onLoad
事件中获取得到,例如:
/**
* 声明周期函数--监听页面加载
*/
onLoad: function(options)
// options 就是导航传递过来的参数对象
console.log(options)
2. 页面事件
下拉刷新
下拉刷新是移动端的专有名词,指通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据。
开启下拉刷新:
- 全局开启:在app.json的 window 节点中,将
enablePullDownRefresh
设置为 true - 局部开启:在页面的 .json 配置文件中,将
enablePullDownRefresh
设置为 true - 在实际开发中,一般使用第二种,为需要的页面单独开启。
配置下拉刷新的窗口样式:
在全局或页面的 .json 配置文件中,通过 backgroundColor
和 backgroundTextStyle
来配置下拉刷新窗口的样式,其中:
backgroundColor
用来配置下拉刷新窗口的背景颜色,仅支持16 进制的颜色值backgroundTextStyle
用来配置下拉刷新 loading 的样式,仅支持 dark 和 light
监听页面的下拉刷新事件:
在页面的 .js 文件中,通过 onPullDownRefresh()
函数即可监听当前页面的下拉刷新事件。
当下拉刷新结束后,loading效果会一直在,不会主动消失,因此需要调用 wx.stopPullDownRefresh
函数来手动隐藏loading效果,停止当前页面的下拉刷新。
例,在页面的 wxml 中有如下的 UI 结构,点击按钮可以让 count 值自增 +1:
//页面结构
<view>count值为:count</view>
<button bindtap="countAdd">+1</button>
//+1按钮的点击事件处理函数
countAdd()
this.setData(
count: this.data.count + 1
)
在触发页面的下拉刷新事件时,若要把count的值重置为0,则:
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function()
this.setData(
count: 0
)
// 当数据重置成功后,调用此函数,关闭下拉刷新效果
wx.stopPullDowmRefresh()
上拉触底
上拉触底是移动端的专有名词,指通过手指在屏幕上的上拉滑动操作,从而加载更多数据。
- 通过
onReachBottom()
函数可监听当前页面的上拉触底事件。 - 上拉触底距离可以在全局或页面的.json配置文件中,通过
onReachBottomDistance
属性来配置。 - 小程序默认的触底距离是50px。
3. 生命周期
生命周期是指一个对象从创建 -> 运行 -> 销毁的整个阶段,强调的是一个时间段。
在小程序中,生命周期分成两类:
- 应用生命周期:指小程序从启动 -> 运行 -> 销毁的过程。
- 页面生命周期:指小程序每个页面的加载 -> 渲染 -> 销毁的过程。
其中,页面的生命周期范围较小,应用程序的生命周期范围较大。如图:
生命周期函数
生命周期函数:是由小程序框架提供的内置函数,会伴随着生命周期自动按次序执行
作用:生命周期函数允许开发者在特定的时间点执行某些特定的操作。如页面刚加载时,可以在onLoad生命周期函数中初始化页面的数据。
注:生命周期强调的是时间段,生命周期函数强调的是时间点。
应用的生命周期函数:
需要在app.js中声明,例如:
//app.js文件
App(
//小程序初始化完成时,执行此函数,全局只触发一次,可以做一些初始化的工作
onLaunch: function(options) ,
//小程序启动,或从后台进入前台显示时触发
onShow : function(options) ,
//小程序从前台进入后台时触发
onHide: function()
)
页面的生命周期函数:
需要在页面的.js文件中进行生命,例如:
//页面的 .js 文件
Page(
onLoad : function(options) , //监听页面加载,一个页面只调用1次
onShow : function() , //监听页面显示
onReady : function() , //监听页面初次渲染完成,一个页面只调用1次
onHide : function() , //监听页面隐藏
onUnload : function() //监听页面卸载,一个页面只调用1次
)
4. WXS脚本
WXS(WerXin Script)是小程序独有的一套脚本语言,结合WXML,可构建出页面的结构。
应用场景:wxml中无法调用在页面的 .js 中定义的函数,但wxml中可以调用wxs中定义的函数。小程序中wxs的经典应用场景就是“过滤器”。
wxs与javascript的关系:
1、wxs有自己的数据类型:number数值类型、string 字符串类型、boolean 布尔类型、object 对象类型、function 函数类型、array 数组类型、date 日期类型、regexp 正则
2、wxs 不支持类似于 ES6 及以上的语法形式
- 不支持:let、const、解构赋值、展开运算符、箭头函数、对象属性简写、etc…
- 支持:var 定义变量、普通 function 函数等类似于 ES5 的语法
3、wxs 遵循 CommonJS 规范:module 对象、require() 函数、module.exports 对象
WXS特点:
- 与JavaScript不同。WXS只是为了降低学习成本,设计时借鉴了大量的JS语法,但二者本质上并不相同
- 不能作为组件的事件回调
“过滤器”的经典应用:
<view>m2.toLower(country)</view>
不能作为组件的事件回调函数,错误用法:
<button bindtap="m2.toLower">按钮</button>
- 隔离性。wxs的运行环境和其他JS代码是隔离的:wxs不能调用js中定义的函数;wxs不能调用小程序提供的API。
- 性能好。在ios设备中,小程序内的wxs会比JS代码块2~30倍
基础语法
内嵌wxs脚本:
wxs代码可以编写在wxml文件的<wxs>
标签内。wxml文件中的每个<wxs></wxs>
标签,必须提供module属性,用来指定当前wxs的模块名称,方便在wxml中访问模块中的成员:
<view>m1.toUpper(username)</view>
<wxs module="m1">
//将文本转为大写形式
module.exports.toUpper = function(str)
return str.toUpperCase()
</wxs>
定义外联的wxs脚本:
wxs代码还可以编写在以 .wxs 为后缀的文件内:
//tools.wxs文件
function toLower(str)
return str.toLowerCase()
module.exports =
toLower: toLower
使用外联的wxs脚本:
在wxml中引入外联的wxs脚本时,必须为<wxs>
标签添加module和src属性:
- module用来指定模块的名称
- src用来指定要引入的脚本的路径,且必须是相对路径
<!-- 调用m2模块中的方法 -->
<view>m2.toLower(country)</view>
<!-- 引用外联的tools.wxs脚本,并命名为m2 --!>
<wxs src="../../utils/tools.wxs" module="m2"></wxs>
以上是关于微信小程序视图与逻辑(页面导航页面事件生命周期WXS脚本)的主要内容,如果未能解决你的问题,请参考以下文章