小程序开发-页面导航(声明式导航/编程式导航)后退导航及传参-下拉刷新和上拉触底事件

目录

一、页面导航

1.1 声明式导航

1.1.1  导航到 tabBar 页面

1.1.2  导航到非 tabBar 页面

1.1.3  后退导航

 

1.2 编程式导航

1.2.1 跳转到 tabbar 页面

 1.2.2 跳转到非 tabbar 页面

1.2.3 后退导航

 

二、导航传参

2.1 声明式导航传参

2.2 编程式导航传参

2.3  在 onLoad 中接收导航参数

三、页面事件

3.1 下拉刷新

 3.2 上拉触底


一、页面导航

 小程序中实现页面导航的两种方式

声明式导航
  • 在页面上声明一个 <navigator> 导航组件
  • 通过点击 <navigator> 组件实现页面跳转
编程式导航
  • 调用小程序的导航 API,实现页面的跳转

1.1 声明式导航

1.1.1  导航到 tabBar 页面

tabBar 页面指的是被配置为 tabBar 的页面。

在使用 <navigator> 组件跳转到指定的 tabBar 页面时,需要指定 url 属性和 open-type 属性,其中:

  • url 表示要跳转的页面的地址,必须以 / 开头
  • open-type 表示跳转的方式,必须为 switchTab

示例代码如下:

 

1.1.2  导航到非 tabBar 页面

tabBar 页面指的是没有被配置为 tabBar 的页面。

在使用 <navigator> 组件跳转到普通的非 tabBar 页面时,则需要指定 url 属性和 open-type 属性,其中:

  • url 表示要跳转的页面的地址,必须以 / 开头
  • open-type 表示跳转的方式,必须为 navigate

示例代码如下:

 注意:为了简便,在导航到非 tabBar 页面时,open-type="navigate" 属性可以省略

1.1.3  后退导航

如果要后退到上一页面或多级页面,则需要指定 open-type 属性和 delta 属性,其中:

  •  open-type 的值必须是 navigateBack,表示要进行后退导航
  •  delta 的值必须是数字,表示要后退的层级

示例代码如下:

 注意:为了简便,如果只是后退到上一页面,则可以省略 delta 属性,因为其默认值就是 1

 

1.2 编程式导航

1.2.1 跳转到 tabbar 页面

调用 wx.switchTab(Object object) 方法,可以跳转到 tabBar 页面。其中 Object 参数对象的属性列表如下:

属性

类型

是否必选

说明

url

string

需要跳转的 tabBar 页面的路径,路径后不能带参数

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数(调用成功、失败都会执行)

实例代码如下:

 

 1.2.2 跳转到非 tabbar 页面

调用 wx.navigateTo(Object object) 方法,可以跳转到非 tabBar 的页面。其中 Object 参数对象的属性列表如下:

属性

类型

是否必选

说明

url

string

需要跳转到的非 tabBar 页面的路径,路径后可以带参数

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数(调用成功、失败都会执行)

实例代码如下:

 

 

1.2.3 后退导航

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

属性

类型

默认值

是否必选

说明

delta

number

1

返回的页面数,如果 delta 大于现有页面数,则返回到首页

success

function

接口调用成功的回调函数

fail

function

接口调用失败的回调函数

complete

function

接口调用结束的回调函数(调用成功、失败都会执行)

 实例代码如下:


 

二、导航传参

2.1 声明式导航传参

navigator 组件的 url 属性用来指定将要跳转到的页面的路径。同时,路径的后面还可以携带参数

  •  参数路径之间使用 ? 分隔
  •  参数键参数值 = 相连
  •  不同参数 分隔

代码示例如下:

 

2.2 编程式导航传参

调用 wx.navigateTo(Object object) 方法跳转页面时,也可以携带参数,代码示例如下:

 

2.3  在 onLoad 中接收导航参数

通过声明式导航传参编程式导航传参所携带的参数,可以直接在 onLoad 事件中直接获取到,示例代码如下:

 

三、页面事件

3.1 下拉刷新

1. 什么是下拉刷新

下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为。

2.启用下拉刷新

启用下拉刷新有两种方式:

全局开启下拉刷新
app.json window 节点中,将 enablePullDownRefresh 设置为 true
局部开启下拉刷新
在页面的 .json 配置文件中,将 enablePullDownRefresh 设置为 true

在实际开发中,推荐使用第 2 种方式,为需要的页面单独开启下拉刷新的效果

3. 配置下拉刷新窗口的样式

在全局或页面的 .json 配置文件中,通过 backgroundColor backgroundTextStyle 来配置下拉刷新窗口的样式,其中:

  backgroundColor 用来配置下拉刷新 窗口的背景颜色 ,仅支持 16 进制的颜色值
  backgroundTextStyle 用来配置下拉刷新 loading 的样式 ,仅支持 dark light

4. 监听页面的下拉刷新事件

在页面的 .js 文件中,通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。

例如,在页面的 wxml 中有如下的 UI 结构,点击按钮可以让 count 值自增 +1

 在触发页面的下拉刷新事件的时候,如果要把 count 的值重置为 0,示例代码如下:

 

5. 停止下拉刷新的效果

当处理完下拉刷新后,下拉刷新的 loading 效果会一直显示,不会主动消失,所以需要手动隐藏下拉刷新的 loading 效果。此时,调用 wx.stopPullDownRefresh() 可以停止当前页面的下拉刷新。示例代码如下:

 

 3.2 上拉触底

上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为。

1. 监听页面的上拉触底事件

在页面的 .js 文件中,通过 onReachBottom() 函数即可监听当前页面的上拉触底事件。示例代码如下:

2. 配置上拉触底距离 

上拉触底距离指的是触发上拉触底事件时,滚动条距离页面底部的距离

可以在全局或页面的 .json 配置文件中,通过 onReachBottomDistance 属性来配置上拉触底的距离。

小程序默认的触底距离是 50px,在实际开发中,可以根据自己的需求修改这个默认值。

 

3. 上拉触底案例

3.1 实现步骤

定义获取随机颜色的方法

 

在页面加载时获取初始数据

 

渲染 UI 结构并美化页面效果

 

在上拉触底时调用获取随机颜色的方法

 

添加 loading 提示效果

 

对上拉触底进行节流处理
data 定义 isloading 节流阀
  • false 表示当前没有进行任何数据请求
  • true 表示当前正在进行数据请求
getColors() 方法中 修改 isloading 节流阀的值
  • 在刚调用 getColors 时将节流阀设置 true
  • 在网络请求的 complete 回调函数中,将节流阀重置为 false
onReachBottom 判断 节流阀的值,从而对数据请求进行节流控制
  • 如果节流阀的值为 true,则阻止当前请求
  • 如果节流阀的值为 false,则发起数据请求

 

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值