微信小程序视图与逻辑(页面导航页面事件生命周期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参数对象的属性如下:

属性类型是否必选说明
urlstring需要跳转的tabBar页面的路径,路径后不能带参数
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)
//页面结构
<button bindtap="gotoMessage">跳转到消息页面</button>

//通过编程式导航,跳转到message页面
gotoMessage() 
	wx.switchTab(
		url: '/pages/message/message'
	)

导航到非tabBar页面:

调用 wx.navigateTo(Object object) 方法,其中Object参数对象的属性列表如下:

属性类型是否必选说明
urlstring需要跳转到的非tabBar页面的路径,路径后可以带参数
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

后退导航:

调用 wx.navigateBack(Object object) 方法,可以返回上一页面或多级页面。其中Object参数对象可选的属性列表如下:

属性类型默认值是否必选说明
deltanumber1返回的页面数,如果delta大于现有页面数,则返回到首页
successfunction-接口调用成功的回调函数
failfunction-接口调用失败的回调函数
completefunction-接口调用结束的回调函数(调用成功、失败都会执行)

导航传参

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 配置文件中,通过 backgroundColorbackgroundTextStyle 来配置下拉刷新窗口的样式,其中:

  • 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>标签添加modulesrc属性:

  • module用来指定模块的名称
  • src用来指定要引入的脚本的路径,且必须是相对路径
<!-- 调用m2模块中的方法 -->
<view>m2.toLower(country)</view>

<!-- 引用外联的tools.wxs脚本,并命名为m2 --!>
<wxs src="../../utils/tools.wxs" module="m2"></wxs>

以上是关于微信小程序视图与逻辑(页面导航页面事件生命周期WXS脚本)的主要内容,如果未能解决你的问题,请参考以下文章

微信小程序(视图与逻辑)

微信小程序页面事件

微信小程序的概要

微信小程序-页面路由及页面生命周期

微信小程序-页面路由及页面生命周期

微信小程序-页面路由及页面生命周期