微信小程序 - 视图与逻辑

【黑马程序员前端微信小程序开发教程，微信小程序从基础到发布全流程_企业级商城实战(含uni-app项目多端部署)】 https://www.bilibili.com/video/BV1834y1676P/?p=44&share_source=copy_web&vd_source=03c1dc52eeb3747825ecad0412c18ab1

页面导航

1. 什么是页面导航

页面导航指的是页面之间的相互跳转。例如，浏览器中实现页面导航的方式有如下两种：
① <a> 链接
② location.href

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

① 声明式导航

• 在页面上声明一个 <navigator> 导航组件
• 通过点击 <navigator> 组件实现页面跳转

② 编程式导航

• 调用小程序的导航 API，实现页面的跳转

声明式导航

1. 导航到 tabBar 页面

tabBar 页面指的是被配置为 tabBar 的页面。
在使用 <navigator> 组件跳转到指定的 tabBar 页面时，需要指定 url 属性和 open-type 属性，其中：

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

<navigator url="/pages/home/home" open-type="switchTab">
跳转到首页
</navigator>

2. 导航到非 tabBar 页面

非 tabBar 页面指的是没有被配置为 tabBar 的页面。
在使用<navigator>组件跳转到普通的非 tabBar 页面时，则需要指定 url 属性和 open-type 属性，其中：

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

<navigator url="/pages/list/list">跳转到非tabBar页面</navigator>

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

3. 后退导航

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

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

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

<navigator open-type="navigateBack" delta="1">
<button>返回上一页</button>
</navigator>

编程式导航

1. 导航到 tabBar 页面

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

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

可选 function：

• success 接口调用成功的回调函数
• fail 接口调用失败的回调函数
• complete 接口调用结束的回调函数（调用成功、失败都会执行）

//wxml
<button bindtap="goToHome">跳转到首页</button>
//js
goToHome(){
    wx.switchTab({
      url: '/pages/home/home',
    })
  },

2. 导航到非 tabBar 页面

调用 wx.navigateTo(Object object) 方法，可以跳转到非 tabBar 的页面。其中 Object 参数对象的属性列表同上。
但是 它的url 允许带参数，和上面不同

//wxml
<button bindtap="goToList">跳转到非tabBar页面</button>
//js
 goToList(){
    wx.navigateTo({
      url: '/pages/list/list',
    })
  },

3. 后退导航

调用 wx.navigateBack(Object object) 方法，可以返回上一页面或多级页面。
可选参数 number :

• delta 返回的页面数，如果 delta 大于现有页面数，则返回到首页 默认为一
  可选参数 function:
  success 接口调用成功的回调函数
  fail 接口调用失败的回调函数
  complete 接口调用结束的回调函数（调用成功、失败都会执行）

//wxml
<button bindtap="BackToLastPage">返回上一页</button>
//js
 BackToLastPage(){
    wx.navigateBack()
  },

导航传参

1. 声明式导航传参

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

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

<navigator url="/pages/list/list?name=time&age=22">跳转到非tabBar页面</navigator>

2. 编程式导航传参

wx.navigateTo(Object object) 方法跳转页面时，也可以携带参数。只针对跳转到非tabBar页面

goToList(){
    wx.navigateTo({
      url: '/pages/list/list?name=time&mag=hi',
    })
  },

3. 在 onLoad 中接收导航参数

通过声明式导航传参或编程式导航传参所携带的参数，可以直接在 onLoad 事件中直接获取到

//被跳转页面的js
  onLoad(options) {
    console.log(options)
  },

页面事件

下拉刷新事件

1. 什么是下拉刷新

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

2. 启用下拉刷新

启用下拉刷新有两种方式：
① 全局开启下拉刷新

• 在 app.json 的 window 节点中，将 enablePullDownRefresh 设置为 true
  ② 局部开启下拉刷新
• 在页面的 .json 配置文件中，将 enablePullDownRefresh 设置为 true
  在实际开发中，推荐使用第 2 种方式，为需要的页面单独开启下拉刷新的效果。

//json
{
  "usingComponents": {},
  "enablePullDownRefresh": true
}

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

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

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

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

在页面的 .js 文件中，通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。
比如我们这里有个点击按钮的自增函数，要求刷新归0

//wxml
<view>
  {{count}}
</view>
<button bindtap="AddCount">count+1</button>

//js
data: {
    count:0
  },
AddCount(){
    this.setData({
      count : this.data.count +1
    })
  },
onPullDownRefresh() {
      this.setData({
        count : 0
      })
  },
//json
{
  "usingComponents": {},
  "enablePullDownRefresh": true
}

5. 停止下拉刷新的效果

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

//js
onPullDownRefresh() {
      wx.stopPullDownRefresh()
  },

上拉触底事件

1. 什么是上拉触底

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

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

在页面的 .js 文件中，通过 onReachBottom() 函数即可监听当前页面的上拉触底事件。

//wxml
<view class="hello">
</view>
//css
.hello{
  width: 100%;
  height: 1400px;
  background-color: cornsilk;
  box-sizing: border-box;
  border: 1px slateblue solid;
}
//js
    /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
     console.log("页面上拉触底事件")
  },

3. 配置上拉触底距离

上拉触底距离指的是触发上拉触底事件时，滚动条距离页面底部的距离。
可以在全局或页面的 .json 配置文件中，通过 onReachBottomDistance 属性来配置上拉触底的距离。
小程序默认的触底距离是 50px，在实际开发中，可以根据自己的需求修改这个默认值。

//json
{
  "usingComponents": {},
  "enablePullDownRefresh": true,
  "onReachBottomDistance": 50
}

案例

下拉触底进行加载 以及显示loading

loading 提示效果
微信开发工具 - 帮助 - 开发者文档 - API - 界面 - 交互
wx.showLoading(Object object)
显示 loading 提示框。需主动调用 wx.hideLoading 才能关闭提示框
title 是必填内容 提示的信息 string类型

对上拉触底进行节流处理

防止触底太多次，请求太多（比如我再底部那里反复滚动，就会调用函数很多次，不合理，修改）
没有请求时才可以请求
有请求时屏蔽其他请求

①在 data 中定义 isloading 节流阀

• false 表示当前没有进行任何数据请求
• true 表示当前正在进行数据请求

② 在 getColors() 方法中修改 isloading 节流阀的值

• 在刚调用 getColors 时将节流阀设置 true
• 在网络请求的 complete 回调函数中，将节流阀重置为 false

③ 在 onReachBottom 中判断节流阀的值，从而对数据请求进行节流控制

• 如果节流阀的值为 true，则阻止当前请求
• 如果节流阀的值为 false，则发起数据请求

//wxml
<view wx:for="{{colorList}}" 
wx:for-key="index"
class="num-item"
style="background-color: rgba({{item}});">
  {{ item }}
</view>

//wxss
.num-item{
  border: 1px solid #efefef;
  border-radius: 8rpx;
  line-height: 200rpx;
  margin:15rpx;
  text-align: center;
  text-shadow: 0rpx 0rpx 5rpx #fff;
  box-shadow: 1rpx 1rpx 6rpx #aaa;
}

//js
data: {
    colorList:[],
    isloading: false
  },
 getColors(){
   this.setData({
     isloading :true
   })
  wx.showLoading({
    "title":"数据加载中"
  })
   wx.request({
     url: 'https://applet-base-api-t.itheima.net/api/color',
     method:'GET',
    
     success:({data:res})=>{
       this.setData({
        //  旧数据和新数据拼接
           colorList: [...this.data.colorList,...res.data]
        })
     },
     complete:()=>{
      wx.hideLoading()
      this.setData({
        isloading :false
      })
    },
     
    
   })
 },
onLoad(options) {
    this.getColors()
  },
 onReachBottom() {
    if (this.data.isloading) return

    this.getColors()
  },

我还发现了个bug，就是那个接口每次给的数据量不一样，假如你第一次编译只给了3个，那你就得重新编译或者刷新，太少了，没有滚动条不能触发效果

自定义编译模式
就是每次重新编译，都会从首页开始，或者tabBar开始，假如你想一刷新就到你在编译的这个页面，你就需要自定义编译。
开发工具 - 编译旁边的普通编译下拉 - 添加编译模式

生命周期

1. 什么是生命周期

生命周期（Life Cycle）是指一个对象从创建 -> 运行 -> 销毁的整个阶段，强调的是一个时间段。例如：

• 张三出生，表示这个人生命周期的开始
• 张三离世，表示这个人生命周期的结束
• 中间张三的一生，就是张三的生命周期

我们可以把每个小程序运行的过程，也概括为生命周期：

• 小程序的启动，表示生命周期的开始
• 小程序的关闭，表示生命周期的结束
• 中间小程序运行的过程，就是小程序的生命周期

2. 生命周期的分类

在小程序中，生命周期分为两类，分别是：
① 应用生命周期

• 特指小程序从启动 -> 运行 -> 销毁的过程
  ② 页面生命周期
• 特指小程序中，每个页面的加载 -> 渲染 -> 销毁的过程
  其中，页面的生命周期范围较小，应用程序的生命周期范围较大：
  小程序启动 - 页面A的周期 - 页面B的周期 - 页面C的周期 - etc... - 小程序结束

3. 什么是生命周期函数

生命周期函数：是由小程序框架提供的内置函数，会伴随着生命周期，自动按次序执行。
生命周期函数的作用：允许程序员在特定的时间点，执行某些特定的操作。例如，页面刚加载的时候，可以在onLoad 生命周期函数中初始化页面的数据。
注意：生命周期强调的是时间段，生命周期函数强调的是时间点

4. 生命周期函数的分类

小程序中的生命周期函数分为两类，分别是：
① 应用的生命周期函数

• 特指小程序从启动 -> 运行 -> 销毁期间依次调用的那些函数

② 页面的生命周期函数

• 特指小程序中，每个页面从加载 -> 渲染 -> 销毁期间依次调用的那些函数

5. 应用的生命周期函数

小程序的应用生命周期函数需要在 app.js 中进行声明

App({
//初始化完成时，执行此函数，全局只触发一次，可以做些基础性的工作
  onLaunch() {
  
  },
  //小程序启动，或者从后台进入前台显示时触发
   onShow(){

  },
  //小程序从前台进入后台时触发
  onHide(){

  }
})

6. 页面的生命周期函数

小程序的页面生命周期函数需要在页面的 .js 文件中进行声明

 /**
   * 生命周期函数--监听页面加载，一个页面只调用一次
   */
  onLoad(options) {
    
  },

  /**
   * 生命周期函数--监听页面初次渲染完成 ,一个页面只调用一次
   */
  onReady() {

  },

  /**
   * 生命周期函数--监听页面显示
   */
  onShow() {

  },

  /**
   * 生命周期函数--监听页面隐藏
   */
  onHide() {

  },

  /**
   * 生命周期函数--监听页面卸载
   */
  onUnload() {

  },

WXS 脚本

概述

1. 什么是 wxs

WXS（WeiXin Script）是小程序独有的一套脚本语言，结合 WXML，可以构建出页面的结构。

2. wxs 的应用场景

wxml 中无法调用在页面的 .js 中定义的函数，但是，wxml 中可以调用 wxs 中定义的函数。因此，小程序中wxs 的典型应用场景就是“过滤器”。
即：渲染数据之前对数据进行包装处理
（vue3中的过滤器已经废弃了）
在微信小程序中调用一个对象的属性时，需要用JS在页面中进行处理，无法直接调用函数，而给js穿参数又费劲。所以用wxs

3. wxs 和 JavaScript 的关系*

虽然 wxs 的语法类似于 JavaScript，但是 wxs 和 JavaScript 是完全不同的两种语言：
① wxs 有自己的数据类型

• number 数值类型、string 字符串类型、boolean 布尔类型、object 对象类型、
• function 函数类型、array 数组类型、 date 日期类型、 regexp 正则

② wxs 不支持类似于 ES6 及以上的语法形式

• 不支持：let、const、解构赋值、展开运算符、箭头函数、对象属性简写、etc...
• 支持：var 定义变量、普通 function 函数等类似于 ES5 的语法

③ wxs 遵循 CommonJS 规范

• module 对象
• require() 函数
• module.exports 对象

基础语法

1. 内嵌 wxs 脚本

wxs 代码可以编写在 wxml 文件中的 <wxs>标签内，就像 Javascript 代码可以编写在 html 文件中的 <script> 标签内一样。
wxml 文件中的每个 <wxs></wxs> 标签，必须提供 module 属性，用来指定当前 wxs 的模块名称，方便在wxml 中访问模块中的成员

//wxml
<view>
  {{m1.toUpper(username)}}
</view>
<wxs module="m1">
 module.exports.toUpper = function(str){
   return str.toUpperCase()
 }
</wxs>

//js
 data: {
    username:"laizhou"
  },

2. 定义外联的 wxs 脚本

wxs 代码还可以编写在以 .wxs 为后缀名的文件内，就像 javascript 代码可以编写在以 .js 为后缀名的文件中一样。、

function toLower(str){
  return str.toLowerCase()
}
module.exports = {
  toLower:toLower
}

3. 使用外联的 wxs 脚本

在 wxml 中引入外联的 wxs 脚本时，必须为 <wxs> 标签添加 module 和 src 属性，其中：

• module 用来指定模块的名称
• src 用来指定要引入的脚本的路径，且必须是相对路径

<view>
  {{m2.toLower(USERName)}}
</view>
<wxs src="../../utils/tools.wxs" module="m2"/>

data: {
    USERName: "LAIZHOU"
  },

WXS 的特点

不能作为组件的事件回调

wxs 典型的应用场景就是“过滤器”，经常配合 Mustache 语法进行使用
但是，在 wxs 中定义的函数不能作为组件的事件回调函数。例如，下面的用法是错误的：

隔离性

隔离性指的是 wxs 的运行环境和其他 JavaScript 代码是隔离的。体现在如下两方面：
① wxs 不能调用 js 中定义的函数
② wxs 不能调用小程序提供的 API

性能好

• 在 iOS 设备上，小程序内的 WXS 会比 JavaScript 代码快 2 ~ 20 倍
• 在 android 设备上，二者的运行效率无差异

案例 - 本地生活（列表页面）

开发者文档 - API - 界面 - 导航栏 - wx.setNavigationBarTitle(Object object)
功能描述：动态设置当前页面的标题
必填string title 页面标题
非必填function success fail complete

开发者文档 - 框架 - 框架接口 - 页面 - Page - onReady()
页面初次渲染完成时触发。一个页面只会调用一次，代表页面已经准备妥当，可以和视图层进行交互。
注意：对界面内容进行设置的 API 如wx.setNavigationBarTitle，请在onReady之后进行。

开发者文档 - API - 界面 - 交互 - wx.showToast(Object object)
显示消息提示框
必填string title 提示的内容
非必填string icon 图标

wxml

<!-- 循环列表 -->
<view class="shop-item" wx:for="{{shopList}}" wx:key="id">
<view class="thumb">
  <image src="{{item.images[0]}}" mode=""/>
</view>
  <view class="info">
     <text class="title">{{item.name}}</text>
     <text>电话:{{tool.splitPhone(item.phone)}}</text>
     <text>地址:{{item.address}}</text>
     <text>营业时间:{{item.businessHours}}</text>
  </view>
</view>

<!-- 引入wxs处理手机号 src是相对路径-->
<wxs src="../../utils/tool.wxs" module="tool"/>

wxs

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
}

wxss样式

.shop-item{
  padding: 15rpx;
  border: 1rpx solid #efefef;
  border-radius: 8rpx;
  box-sizing: border-box;
  margin:15rpx;
  box-shadow: 1rpx 1rpx 6rpx #aaa;
  display: flex;
}
.thumb image{
  width: 250rpx;
  height: 100%;
  display: block;
  margin-right:15rpx;
}
.info{
  display: flex;
  flex-direction: column;
  justify-content: space-around;
  font-size: medium;
}
.title{
  font-size: larger;
  font-weight: 700;
}

js

Page({

  /**
   * 页面的初始数据
   */
  data: {
    query:{},
    shopList:[],
	//page 是页码
    page:1,
	//pageSize 是一页里有几个item,不是指页码的上限
    pageSize:10,
	//total 是指总共的item
	//判断是否加载页数够了
	//page * pageSize >= total
    total:0,
	// 下面这个是用来loading节流的
    onLoading:false
  },
//这个cb,下拉刷新时传东西，让它自动回弹
  getshopList(cb) {
    this.setData({
      onLoading:true,
    })
    wx.showLoading({
      title: '数据加载中...',
    })
    wx.request({
      url: `https://applet-base-api-t.itheima.net/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],
          // 这个-0，是字符串转数字类型
          total: res.header['X-Total-Count']-0
        })
      },
      complete:()=>{
        wx.hideLoading(),
        this.setData({
          onLoading:false
        })
        cb && cb()
      }
    })

  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
   this.setData({
     query: options,
   }),
   this.getshopList() 
  },

  /**
   * 生命周期函数--监听页面初次渲染完成
   */
  onReady() {
    wx.setNavigationBarTitle({
      title: this.data.query.title,
    })
  },

  /**
   * 页面相关事件处理函数--监听用户下拉动作
   */
  onPullDownRefresh() {

    // 刷新关键数据
    this.setData({
      page:1,
      total:0,
      shopList:[]
    })
    // 重新进行请求
    this.getshopList(()=>{
      wx.stopPullDownRefresh()
    })

    // 上拉页回弹 wx.stopPullDownRefresh()
    // 这里我们没有这样写，是因为假如网卡
    // 生命周期函数里面，万一请求时间小于timeout时间，
    // 数据回来了，还没关闭刷新
  },

  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
    if (this.data.onLoading) return
    if (this.data.page*this.data.pageSize >= this.data.total) {
      return wx.showToast({
        title: '已经到底了',
        icon:'none'
      })
    }
    this.setData({
      page:this.data.page + 1
    })
    this.getshopList()
  }

json

{
  "usingComponents": {},
  "enablePullDownRefresh": true,
  "backgroundColor": "#efefef",
  "backgroundTextStyle": "dark",
  "onReachBottomDistance": 150
}