页面导航指的是页面之间的相互跳转
浏览器中实现页面导航的方式有如下两种:
location.href
tabBar 页面指的是被配置为 tabBar 的页面。
在使用
示例如下:
导航到首页
测试过程:点击 "导航到首页" 会跳转到home页面
非 tabBar 页面指的是没有被配置为 tabBar 的页面
在使用
示例如下:
导航到index页面
测试过程:点击 "导航到index页面" 会跳转到 index 页面
为了简便,在导航到非 tabBar 页面时,open-type="navigate" 属性可以省略
如果要后退到上一页面或多级页面,则需要指定 open-type 属性和 delta 属性
示例如下:
返回上一页
为了简便,如果只是后退到上一页面,则可以省略 delta 属性,因为其默认值就是 1
调用 wx.switchTab(Object object) 方法,可以跳转到 tabBar 页面
其中 Object 参数对象的属性列表如下:
属性 | 类型 | 是否必选 | 说明 |
url | string | 是 | 需要跳转的 tabBar 页面的路径,路径后不能带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码如下:
gotoMessage(){
wx.switchTab({
url: '/pages/home/home',
})
}
调用 wx.navigateTo(Object object) 方法,可以跳转到非 tabBar 页面
其中 Object 参数对象的属性列表如下:
属性 | 类型 | 是否必选 | 说明 |
url | string | 是 | 需要跳转的 tabBar 页面的路径,路径后不能带参数 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
wx.navigate(Object object) 与 wx.switchTab(Object object) 中 Oject 参数对象的属性列表一样
示例代码如下:
gotoIndex(){
wx.navigateTo({
url: '/pages/index/index',
})
}
调用 wx.navigateBack(Object object) 方法,可以上一级或多级页面
其中 Object 参数对象的属性列表如下:
属性 | 类型 | 是否必选 | 说明 |
delta | number | 否 | 返回的页面数,delta 默认值为1。若 delta 大于现有页面数,则返回首页 |
success | function | 否 | 接口调用成功的回调函数 |
fail | function | 否 | 接口调用失败的回调函数 |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码如下:
gotoBack(){
wx.navigateBack();
}
navigator 组件的 url 属性用来指定将要跳转到的页面的路径。同时,路径的后面还可以携带参数
格式如下:
跳转到message页面
调用 wx.navigateTo(Object object) 方法跳转页面时,也可以携带参数
示例代码如下:
gotoIndex(){
wx.navigateTo({
url:'/pages/index/index?name=chenmo&age=19',
})
}
通过声明式导航传参或编程式导航传参所携带的参数,可以直接在 onLoad 事件中直接获取到
示例代码如下:
/**
* 生命周期函数--监听页面加载
*/
onLoad(options) {
// options 是导航传递过来的参数对象
console.log(options);
}
下拉刷新事件的启动与配置见 2.3.2.6
在页面的 .js 文件中,通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件
示例如下:
// Add按钮的点击事件处理函数
countAdd(){
this.setData({
count: this.data.count + 1,
});
console.log(this.data.count);
}
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
// 在触发页面的下拉刷新事件的时候,把 count 的值重置为 0
onPullDownRefresh(){
this.setData({
count: 0
})
console.log(this.data.count);
// 当数据重置成功之后,调用此函数,关闭下拉刷新的效果
wx.stopPullDownRefresh();
}
// 页面结构
当处理完下拉刷新后,下拉刷新的 loading 效果会一直显示,不会主动消失,所以需要手动隐藏下拉刷新的loading 效果。此时,调用 wx.stopPullDownRefresh() 可以停止当前页面的下拉刷新
注意:
在创建好页面时,页面.js 文件中已经自动创建好了 onPullDownRefresh() 函数,故无需自己创建一个,只需在其中编写代码即可,若全都自己编写需要删除已经创建好的函数,否则两个同名函数同时存在的话,编译器会默认自动创建好的函数去执行
上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为
在页面的 .js 文件中,通过 onReachBottom() 函数即可监听当前页面的上拉触底事件
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom() {
console.log('触发了上拉触底事件')
}
上拉触底距离:触发上拉触底事件时,滚动条距离页面底部的距离
可以在全局或页面的 .json 配置文件中,通过 onReachBottomDistance 属性来配置上拉触底的距离,小程序默认的触底距离是 50px
效果如下:
实现步骤:
// pages/list/list.js
Page({
/**
* 页面的初始数据
*/
data: {
// 随机颜色列表
colorList: [],
// 节流阀 false-当前没有进行任何数据请求 true-正在进行数据请求
isloading: false
},
/* 获取随机颜色的方法 */
getColors(){
// 正在进行数据请求,设置为 true
this.setData({
isloading: true
})
// 5.1 添加 loading 效果
wx.showLoading({
title: '数据加载中...',
})
// 发送请求,获取随机颜色值的数组
wx.request({
url: 'https://www.escook.cn/api/color',
method: 'GET',
success:({data: res}) => {
this.setData({
colorList: [...this.data.colorList,...res.data]
})
},
// 5.2 获取成功后隐藏 loading 效果
complete: () => {
wx.hideLoading()
// 数据请求完毕,设置为 false
this.setData({
isloading: false
})
}
})
},
/**
* 生命周期函数--监听页面加载
*/
onLoad(options) {
this.getColors();
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom() {
// 判断节流阀的值,对数据请求进行节流控制
// isloading:true 代表正在进行数据请求,故应该阻止当前上拉事件请求
// isloading:false 发起数据请求
if(!this.data.isloading){
this.getColors();
}
}
})
/* pages/list/list.wxss */
.num-item{
border: 1rpx solid #efefef;
border-radius: 8rpx;
line-height: 200rpx;
margin: 15rpx;
text-align: center;
text-shadow: 0rpx 0rpx 5rpx #fff;
box-shadow: 1rpx 1rpx 5rpx #aaa;
}
{{item}}
生命周期(Life Cycle)是指一个对象从创建 -> 运行 -> 销毁的整个阶段,强调的是一个时间段
把每个小程序运行的过程,也概括为生命周期:
在小程序中,生命周期分为两类,分别是:
其中,页面的生命周期范围较小,应用程序的生命周期范围较大,如图所示:
生命周期函数:是由小程序框架提供的内置函数,会伴随着生命周期,自动按次序执行
生命周期函数的作用:允许程序在特定的时间点,执行某些特定的操作
例如:页面刚加载的时候,可以在onLoad 生命周期函数中初始化页面的数据
注意:生命周期强调的是时间段,生命周期函数强调的是时间点
同样,小程序中的生命周期函数分为两类,分别是:
应用生命周期函数需要在 app.js 中进行声明
示例如下:
// app.js
App({
// 小程序初始化完成时,执行此函数,全局只触发一次,可以做一些初始化工作
onLaunch(options){
},
// 小程序启动,或从后台进入前台显示时触发
onShow(options){
},
// 小程序从前台进入后台时触发
onHide(){
}
})
页面生命周期函数需要在页面的 .js 文件中进行声明
示例如下:
// pages/list/list.js
Page({
/**
* 生命周期函数--监听页面加载
*/
onLoad(options) {
},
/**
* 生命周期函数--监听页面初次渲染完成
*/
onReady() {
},
/**
* 生命周期函数--监听页面显示
*/
onShow() {
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide() {
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload() {
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh() {
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom() {
},
/**
* 用户点击右上角分享
*/
onShareAppMessage() {
}
})
WXS(WeiXin Script)是小程序独有的一套脚本语言,结合 WXML,可以构建出页面的结构
wxml 中无法调用在页面的 .js 中定义的函数,但是,wxml 中可以调用 wxs 中定义的函数
因此,小程序中wxs 的典型应用场景就是“过滤器”
wxs 的语法 类似于 JavaScript,但两者是不同的语言
wxs 代码可以编写在 wxml 文件中的
wxml 文件中的每个
示例如下:
// username 在页面的js文件中 data 中定义
{{m1.toUpper(username)}}
// 将文本转为大写形式
module.exports.toUpper = function(str){
return str.toUpperCase()
}
wxs 代码还可以编写在以 .wxs 为后缀名的文件内,就像 javascript 代码可以编写在以 .js 为后缀名的文件中一样
在 wxml 中引入外联的 wxs 脚本时,必须为
示例如下:
// list.wxs
function toLower(str){
return str.toLowerCase();
}
module.exports = {
toLower : toLower
}
{{m2.toLower(name)}}
为了降低 wxs(WeiXin Script)的学习成本, wxs 语言在设计时借大量鉴了 JavaScript 的语法。但是本质上,wxs 和 JavaScript 是完全不同的两种语言!
wxs 典型的应用场景就是“过滤器”,经常配合 Mustache 语法进行使用,
如下:
{{m2.toLower(name)}}
但是,在 wxs 中定义的函数不能作为组件的事件回调函数
如下用法是错误的:
隔离性指的是 wxs 的运行环境和其他 JavaScript 代码是隔离的,具体如下:
2. 列表页面的 API 接口
以分页的形式,加载指定分类下商铺列表的数据:
// pages/shoplist/shoplist.js
Page({
/**
* 页面的初始数据
*/
data: {
query: {},
shopList: [],
page: 1,
pageSize: 10,
total: 0,
isloading: false
},
/**
* 生命周期函数--监听页面加载
*/
onLoad: function (options) {
this.setData({
query: options
})
this.getShopList()
},
// 以分页的形式获取商铺列表数据的方法
getShopList(cb) {
this.setData({
isloading: true
})
// 展示 loading 效果
wx.showLoading({
title: '数据加载中...'
})
wx.request({
url: `https://www.escook.cn/categories/${this.data.query.id}/shops`,
method: 'GET',
data: {
_page: this.data.page,
_limit: this.data.pageSize
},
success: (res) => {
this.setData({
shopList: [...this.data.shopList, ...res.data],
total: res.header['X-Total-Count'] - 0
})
},
complete: () => {
// 隐藏 loading 效果
wx.hideLoading()
this.setData({ isloading: false })
// wx.stopPullDownRefresh()
cb && cb()
}
})
},
/**
* 生命周期函数--监听页面初次渲染完成
*/
onReady: function () {
wx.setNavigationBarTitle({
title: this.data.query.title
})
},
/**
* 生命周期函数--监听页面显示
*/
onShow: function () {
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide: function () {
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload: function () {
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
// 需要重置关键的数据
this.setData({
page: 1,
shopList: [],
total: 0
})
// 重新发起数据请求
this.getShopList(() => {
wx.stopPullDownRefresh()
})
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
if (this.data.page * this.data.pageSize >= this.data.total) {
// 证明没有下一页的数据了
return wx.showToast({
title: '数据加载完毕!',
icon: 'none'
})
}
// 判断是否正在加载其他数据
if (this.data.isloading) return
// 页码值 +1
this.setData({
page: this.data.page + 1
})
// 获取下一页数据
this.getShopList()
},
/**
* 用户点击右上角分享
*/
onShareAppMessage: function () {
}
})
/* pages/shoplist/shoplist.wxss */
.shop-item {
display: flex;
padding: 15rpx;
border: 1rpx solid #efefef;
border-radius: 8rpx;
margin: 15rpx;
box-shadow: 1rpx 1rpx 15rpx #ddd;
}
.thumb image {
width: 250rpx;
height: 250rpx;
display: block;
margin-right: 15rpx;
}
.info {
display: flex;
flex-direction: column;
justify-content: space-around;
font-size: 24rpx;
}
.shop-title {
font-weight: bold;
}
function splitPhone(str) {
if(str.length !== 11) return str
var arr = str.split('')
arr.splice(3, 0, '-')
arr.splice(8, 0, '-')
return arr.join('')
}
module.exports = {
splitPhone: splitPhone
}
{{item.name}}
电话:{{tools.splitPhone(item.phone)}}
地址:{{item.address}}
营业时间:{{item.businessHours}}
{{item.name}}
留言与评论(共有 0 条评论) “” |