主题:[hexo数学家](https://zhwangart.com/)添加Waline评论。


# 一、主题添加Waline评论

## 1、安装依赖

```
在Hexo目录执行 
npm install @waline/hexo-next
```

2、主题config配置添加

[waline属性官网网址](https://waline.js.org/reference/client/props.html#serverurl)

```
waline:
  enable: true  #是否开启
  el: 'vcomments'      # Valine 的初始化挂载器，无需更改
  serverURL: http://自己的域名:8360 # Waline #服务端地址，我们这里就是上面部署的 Vercel 地址
  placeholder: 请文明评论呀 # #评论框的默认文字
  avatar: mm # 头像风格
  meta: [nick, mail, link] # 自定义评论框上面的三个输入框的内容
  pageSize: 10 # 评论数量多少时显示分页
  lang: zh-cn # 语言, 可选值: en, zh-cn
  # Warning: 不要同时启用 `waline.visitor` 以及 `leancloud_visitors`.
  visitor: false # 文章阅读统计
  comment_count: true # 如果为 false , 评论数量只会在当前评论页面显示, 主页则不显示
  requiredFields: [] # 设置用户评论时必填的信息，[nick,mail]: [nick] | [nick, mail]
  libUrl: # Set custom library cdn url
```

3、创建ejs文件

themes\ocean\layout\_partial\post\waline.ejs

```
<% if (theme.waline.enable) { %>
<div class="vcomments" id="<%- theme.waline.el %>"></div>
<%- js('//unpkg.com/@waline/client@v2/dist/waline.js') %>
<link href='//unpkg.com/@waline/client@v2/dist/waline.css' rel='stylesheet' />
<script>
  Waline.init({
    el: '#<%- theme.waline.el %>',
	serverURL: '<%- theme.waline.serverURL%>',
    avatar: '<%- theme.waline.avatar %>',
    //meta: [<%- theme.waline.requiredFields %>],
	requiredMeta: ['mail'], #直接在这个文件赋值,否则引入变量不会带单引号
	wordLimit: <%- theme.waline.wordLimit %>,
	pageSize: '<%- theme.waline.pageSize %>',
	lang: '<%- theme.waline.lang %>',
	visitor: '<%- theme.waline.visitor %>',
	comment_count: '<%- theme.waline.comment_count %>',
    placeholder: '<%- theme.waline.placeholder %>'
	
  })
</script>
<% } %>
```

4、页面最下方显示评论

ocean\layout\_partial\article.ejs

```
  <% if (is_post()) { %>
  <%- partial('post/waline') %>
  <%- partial('post/valine') %>
  <%- partial('post/gitalk') %>
  <%} %>
```

# 二、Waline

## 1.MYSQL

### 1.1.导入库waline.sql

这里在服务器的mysql中创建库

```
CREATE DATABASE waline DEFAULT CHARACTER SET utf8mb4;

CREATE TABLE `wl_Comment` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `user_id` int(11) DEFAULT NULL,
  `comment` text,
  `insertedAt` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `ip` varchar(100) DEFAULT '',
  `link` varchar(255) DEFAULT NULL,
  `mail` varchar(255) DEFAULT NULL,
  `nick` varchar(255) DEFAULT NULL,
  `pid` int(11) DEFAULT NULL,
  `rid` int(11) DEFAULT NULL,
  `sticky` int(11) DEFAULT NULL,
  `status` varchar(50) NOT NULL DEFAULT '',
  `ua` text,
  `url` varchar(255) DEFAULT NULL,
  `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `wl_Counter` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `time` int(11) DEFAULT NULL,
  `url` varchar(255) NOT NULL DEFAULT '',
  `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `wl_Users` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `display_name` varchar(255) NOT NULL DEFAULT '',
  `email` varchar(255) NOT NULL DEFAULT '',
  `password` varchar(255) NOT NULL DEFAULT '',
  `type` varchar(50) NOT NULL DEFAULT '',
  `url` varchar(255) DEFAULT NULL,
  `avatar` varchar(255) DEFAULT NULL,
  `github` varchar(255) DEFAULT NULL,
  `twitter` varchar(255) DEFAULT NULL,
  `facebook` varchar(255) DEFAULT NULL,
  `google` varchar(255) DEFAULT NULL,
  `weibo` varchar(255) DEFAULT NULL,
  `qq` varchar(255) DEFAULT NULL,
  `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

## 2.docker

### 2.1.拉取镜像

```
docker pull lizheming/waline:latest  #拉取镜像
```

### 2.2.启动并运行

点击[官网](https://console.leancloud.cn/login)注册,并且绑定安全域名

```
//参数在官网:https://waline.js.org/reference/server/config.html#disallowiplist

docker run -d --name waline -p 8360:8360
-v /software/docker/waline-blog:/app/data  #挂在镜像
-e TZ="Asia/Shanghai"
-e MYSQL_HOST="192.168.1.88"	#MYSQL ip
-e MYSQL_DB="waline"			#MYSQL 库名
-e MYSQL_USER="**"				#MYSQL 用户名
-e MYSQL_PASSWORD="**"			#MYSQL 密码
-e AUTHOR_EMAIL="**@qq.com"		#发送邮箱
-e SITE_NAME="陈少华的博客"		
-e SENDER_NAME="博客留言"
-e SITE_URL="www.chensh888.com" #博客地址
-e SMTP_SERVICE="QQ"			#发送邮箱类型
-e SMTP_USER="**@qq.com"		#发送邮箱
-e SMTP_PASS="**" 				#QQ特有的第三TOKEN
-e SECURE_DOMAINS='chensh888.com,www.chensh888.com' #生效博客域名
-e DISABLE_USERAGENT="false"
-e IPQPS="30"
--restart always
lizheming/waline:latest
```

根据容器中的源码查看的参数如下，请根据实际与官网比对填写。

```
module.exports = {
  workers: 1,
  storage,
  jwtKey,
  forbiddenWords,
  disallowIPList: [],
  secureDomains: SECURE_DOMAINS ? SECURE_DOMAINS.split(/\s*,\s*/) : undefined,
  disableUserAgent: DISABLE_USERAGENT && !isFalse(DISABLE_USERAGENT),
  disableRegion: DISABLE_REGION && !isFalse(DISABLE_REGION),
  levels:
    !LEVELS || isFalse(LEVELS)
      ? false
      : LEVELS.split(/\s*,\s*/).map((v) => Number(v)),
  avatarProxy,
  oauthUrl,
  markdown,
  mailSubject: MAIL_SUBJECT,
  mailTemplate: MAIL_TEMPLATE,
  mailSubjectAdmin: MAIL_SUBJECT_ADMIN,
  mailTemplateAdmin: MAIL_TEMPLATE_ADMIN,
  QQTemplate: QQ_TEMPLATE,
  TGTemplate: TG_TEMPLATE,
  WXTemplate: WX_TEMPLATE,
  DiscordTemplate: DISCORD_TEMPLATE,
  LarkTemplate: LARK_TEMPLATE,
};
```

Hexo添加Waline评论

-  页面导航
-  页面事件
-  生命周期
-  WXS 脚本



# 一、页面导航

## 1.什么是页面导航

页面导航指的是页面之间的相互跳转。例如，浏览器中实现页面导航的方式有如下两种：

- `<a>` 链接
- `location.href`

## 2.小程序中实现页面导航的两种方式
- 声明式导航
  - 在页面上声明一个 `<navigator>` 导航组件
  - 通过点击` <navigator>` 组件实现页面跳转
- 编程式导航
  - 调用小程序的导航 API，实现页面的跳转

## 3.声明式导航

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

- url 表示要跳转的页面的地址，必须以 / 开头

- open-type 表示跳转的方式，必须为 switchTab

**示例代码如下：**

```
<navigator url="/pages/message/message" open-type="switchTab">声明式跳转消息</navigator>
```

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

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

**示例代码如下：**

```
# 注意：为了简便，在导航到非 tabBar 页面时，open-type="navigate" 属性可以省略。
<navigator url="/pages/info/info" open-type="navigate">声明式跳转info</navigator>
```

### 3.3.后退导航
如果要后退到上一页面或多级页面，则需要指定 open-type 属性和 delta 属性，其中：
- open-type 的值必须是 navigateBack，表示要进行后退导航
- delta 的值必须是数字，表示要后退的层级

**示例代码如下：**

```
# 注意：为了简便，如果只是后退到上一页面，则可以省略 delta 属性，因为其默认值就是 1。
<navigator open-type="navigateBack" delta="1">声明式返回上一页</navigator>
```

## 4.编程式导航
### 4.1.导航到 tabBar 页面

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

表格来源: [小程序官网switchTab](https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html)

| 属性     | 类型     | 默认值 | 必填 | 说明                                                         |
| :------- | :------- | :----- | :--- | :----------------------------------------------------------- |
| url      | string   |        | 是   | 需要跳转的 tabBar 页面的路径 (代码包路径)（需在 app.json 的 [tabBar](https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#tabbar) 字段定义的页面），路径后不能带参数。 |
| success  | function |        | 否   | 接口调用成功的回调函数                                       |
| fail     | function |        | 否   | 接口调用失败的回调函数                                       |
| complete | function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行）             |

**示例代码如下：**

```
// 页面标签
<button bindtap="skipMessage" type="primary" >编程式跳转消息</button>

 /**
  * 通过编程式跳转到message页面
  */
 skipMessage(){
   wx.switchTab({
     url: '/pages/message/message',
   })
 },
```

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

表格来源: [小程序官网navigateTo](https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateTo.html)

| 属性      | 类型     | 默认值 | 必填 | 说明                                                         |
| :-------- | :------- | :----- | :--- | :----------------------------------------------------------- |
| url       | string   |        | 是   | 需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 `?` 分隔，参数键与参数值用 `=` 相连，不同参数用 `&` 分隔；如 'path?key=value&key2=value2' |
| events    | Object   |        | 否   | 页面间通信接口，用于监听被打开页面发送到当前页面的数据。基础库 2.7.3 开始支持。 |
| routeType | string   |        | 是   | 2.29.2 自定义路由类型，相关文档 [自定义路由](https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/custom-route.html) |
| success   | function |        | 否   | 接口调用成功的回调函数                                       |
| fail      | function |        | 否   | 接口调用失败的回调函数                                       |
| complete  | function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行）             |

**示例代码如下：**

```
// 页面标签
<button bindtap="skipInfo" type="primary" plain>编程式跳转info</button>

  /**
   * 通过编程式跳转到Info页面
   */
  skipInfo(){
    wx.navigateTo({
      url: '/pages/info/info'
    })
  },
```

### 4.3.后退导航
调用 wx.navigateBack(Object object) 方法，可以返回上一页面或多级页面。其中 Object 参数对象可选的属性列表如下：

表格来源: [小程序官网navigateBack](https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateBack.html)

| 属性     | 类型     | 默认值 | 必填 | 说明                                                    |
| :------- | :------- | :----- | :--- | :------------------------------------------------------ |
| delta    | number   | 1      | 否   | 返回的页面数，如果 delta 大于现有页面数，则返回到首页。 |
| success  | function |        | 否   | 接口调用成功的回调函数                                  |
| fail     | function |        | 否   | 接口调用失败的回调函数                                  |
| complete | function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行）        |

**示例代码如下：**

```
// 页面标签
<button bindtap="skipBack" type="primary" >编程式跳转info</button>
  /**
   * 编程式导航，返回上一层
   */
  skipBack(){
    wx.navigateBack({
      delta:1,
      success: (res) => {
        console.log("成功打印");
      }
    })
  },
```

## 5.导航传参

### 5.1.声明式、编程式导航传参一致

 url 路径的后面可以携带参数：

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

**示例代码如下：**

```
/pages/info/info?name=张三&age=18
```

### 5.2.在 onLoad 中接收导航参数
通过声明式导航传参或编程式导航传参所携带的参数，可以直接在 onLoad 事件中直接获取到，示例代码如下：

```
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    console.log(options);
  },
```

# 二、页面事件

## 1.下拉刷新事件

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

### 1.2. 启用下拉刷新
**启用下拉刷新有两种方式**：

- 全局开启下拉刷新
  - 在 app.json 的 window 节点中，将 `enablePullDownRefresh` 设置为 true

- 局部开启下拉刷新
  - 在页面的 .json 配置文件中，将 `enablePullDownRefresh` 设置为 true



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

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

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

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

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

```
# 页面标签
<view>
 count值是: {{ count }}
</view>
<button bindtap="addCount">+1</button>

/**
 * 点击 count + 1
 */
addCount(){
  this.setData({
    count: this.data.count + 1
  });
},
```

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

```
/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  console.log("触发了下拉刷新");
  this.setData({
    count: 0
  });
},
```

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

```
/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  console.log("触发了下拉刷新");
  this.setData({
    count: 0
  });
  //当数据修改完成后,关闭下拉框
  wx.stopPullDownRefresh();
},
```

## 2.上拉触底事件
### 2.1.什么是上拉触底
**上拉触底**是移动端的专有名词，通过手指在屏幕上的上拉滑动操作，从而**加载更多数据**的行为。

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

```
/**
 * 页面上拉触底事件的处理函数
 */
onReachBottom() {
  console.log("出发了上拉触底的事件");
},
```

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

### 2.4.上拉触发案例

点击tabBar初始化随机10个颜色卡片展示,每当上拉触底新的随机10个颜色。效果如下:

<img src="https://chensh888.com:8090/file/blog/2023/20230413132953.png" alt="image-20230413132838589" style="zoom: 67%;" />

**案例的实现步骤:**

1. 定义获取随机颜色的方法
1. 在页面加载时获取初始数据
1. 渲染 UI 结构并美化页面效果
1. 在上拉触底时调用获取随机颜色的方法
1. 添加 loading 提示效果
1. 对上拉触底进行节流处理

**最终代码:**

页面元素、样式(.wxml、.wxss):

```

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

.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:  0rpx 0rpx 5rpx #aaa;
}
```

.js方法:

```
  /**
   * 页面的初始数据
   */
  data: {
    //存放颜色
    colorList:[],
    //loding效果
    isLoding: false
  },
    /**
   * 获取颜色数据
   */
  getColors(){
    this.setData({
      isLoding: true
    });
    wx.showLoading({
      title: '数据加载中...',
    });
    wx.request({
      url: 'https://www.escook.cn/api/color',
      method:'GET',
      success: ({
          data: res
        }) => {
        console.log(res);
        this.setData({
          //es6语法 2个数组合并
          colorList: [...this.data.colorList,...res.data]
        });
      },
      complete: (res) =>{
        wx.hideLoading();
        this.setData({
          isLoding: false
        });
      }
    })
  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    this.getColors();
  },
  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
    if(this.data.isLoding)return;
    this.getColors();
  },
```

# 三、生命周期

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

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

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

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

## 2.生命周期的分类
在小程序中，生命周期分为两类，分别是：

- **应用生命周期**
  - 特指小程序从启动 -> 运行 -> 销毁的过程
  
- **页面生命周期**
  - 特指小程序中，每个页面的加载 -> 渲染 -> 销毁的过程

其中，**页面**的生命周期**范围较小**，**应用程序**的生命周期**范围较大**，如图所示：

![image-20230413134534285](https://chensh888.com:8090/file/blog/2023/20230413134537.png)

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

**注意：生命周期强调的是时间段，生命周期函数强调的是时间点。**

## 4.生命周期函数的分类
小程序中的生命周期函数分为两类，分别是：

- **应用的生命周期函数**
  - 特指小程序从启动 -> 运行 -> 销毁期间依次调用的那些函数
- **页面的生命周期函数**
  - 特指小程序中，每个页面从加载 -> 渲染 -> 销毁期间依次调用的那些函数

## 5.应用的生命周期函数
小程序的应用生命周期函数需要在 app.js 中进行声明，示例代码如下：

```
// app.js
App({

  /**
   * 当小程序初始化完成时，会触发 onLaunch（全局只触发一次）
   */
  onLaunch: function () {},

  /**
   * 当小程序启动，或从后台进入前台显示，会触发 onShow
   */
  onShow: function (options) {},

  /**
   * 当小程序从前台进入后台，会触发 onHide
   */
  onHide: function () {},
})
```

## 6.页面的生命周期函数
小程序的页面生命周期函数需要在页面的 .js 文件中进行声明，示例代码如下：

```
// pages/message/message.js
Page({

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

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

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

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

  /**
   * 生命周期函数--监听页面卸载
   * 一个页面只调用1次
   */
  onUnload() {},
})
```

# 四、WXS 脚本

## 1.概述
### 1.1.什么是 wxs
WXS（WeiXin Script）是小程序独有的一套脚本语言，结合 WXML，可以构建出页面的结构。

### 1.2.wxs 的应用场景
wxml 中无法调用在页面的 .js 中定义的函数，但是，wxml 中可以调用 wxs 中定义的函数。因此，小程序中wxs 的典型应用场景就是"过滤器"。

### 1.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 对象
  - *module.exports* 对象

## 2.基础语法
### 2.1.内嵌 wxs 脚本
wxs 代码可以编写在 wxml 文件中的` <wxs>` 标签内，就像 Javascript 代码可以编写在 html 文件中的 `<script> `标签内一样。
wxml 文件中的每个` <wxs></wxs> `标签，**必须提供 module 属性**，用来指定**当前 wxs 的模块名称**，方便在
wxml 中访问模块中的成员：

```

<view>
  {{m1.toUpper(userName)}}
</view>

<wxs module="m1">
    module.exports.toUpper = function(str){
      return str.toUpperCase();
    }
</wxs>
```

### 2.2.定义外联的 wxs 脚本
wxs 代码还可以编写在以 .wxs 为后缀名的文件内，就像 javascript 代码可以编写在以 .js 为后缀名的文件中一样。示例代码如下：

**一般创建到根目录中的utils文件夹中:**

```
function toLower(str){
  return str.toLowerCase();
}

module.exports = {
  toLower : toLower
}
```

### 2.3.使用外联的 wxs 脚本
在 wxml 中引入外联的 wxs 脚本时，必须为 <wxs> 标签添加 module 和 src 属性，其中：
- module 用来指定模块的名称
- src 用来指定要引入的脚本的路径，且必须是相对路径

示例代码如下：

```
<view> {{m2.toLower(userName)}} </view>

<wxs module="m2" src="/utils/tools.wxs"></wxs>
```

## 3.WXS 的特点
### 3.1.与 JavaScript 不同
为了降低 wxs（WeiXin Script）的学习成本， wxs 语言在设计时借大量鉴了 JavaScript 的语法。但是本质上，wxs 和 JavaScript 是完全不同的两种语言！

### 3.2.不能作为组件的事件回调
wxs 典型的应用场景就是**"过滤器"，经常配合 Mustache 语法进行使用**，例如：

```
<view > {{m2.toLower(userName)}} </view>
```

但是，在 wxs 中定义的函数**不能作为组件的事件回调函数**。例如，下面的用法是错误的：

```
<button bindtap="m2.toLower">按钮</button>
```

### 3.3.隔离性
**隔离性**指的是 wxs 的运行环境和其他 JavaScript 代码是隔离的。体现在如下两方面：

- wxs 不能调用 js 中定义的函数
- wxs 不能调用小程序提供的 API

### 3.4.性能好
- 在 **iOS 设备**上，小程序内的 **WXS** 会比 JavaScript 代码**快 2 ~ 20 倍**
- 在 **android 设备**上，二者的运行效率**无差异**

微信小程序-视图与逻辑

Docker Compose部署多个应用实战练习部署nginx和jar包。

部署项目为若依的前后端分离项目,前端使用vue+nginx部署。后端springBoot，以jar包部署。



# 一丶准备资源

文件列表:

- app
  - app.jar
- nginx
  - cong
  - html
  - log
- docker-compose.yml

# 二、配置nginx

&emsp;首先nginx配置文件请根据我的{% post_link 运维/docker/4、Docker安装软件 docker安装nginx文章%}，3个文件夹保存到宿主机中，分别为:conf、html、log

&emsp;nginx配置文件根据自己实际测试项目配置，不会的百度的nginx部署vue项目。

# 三、编写docker-compose.yml

问题: 在反复部署中我遇到后端服务port 端口不生效

解决:加入了`stdin_open`、`tty` 。其中 `stdin_open` 相当于 `run` 命令中的 `-d`,其中 `tty` 相当于 `run` 命令中的 `-i`

```yml
version: '3'        # 自定义版本号，一般是2，3
services:
    #前端 nginx
    my-nginx-pro1: # 服务名称
        image: nginx # 创建容器时所需的镜像
        container_name: my-nginx-pro1 # 容器名称，默认为"工程名称_服务条目名称_序号"
        restart: "always" #重启策略，能够使服务保持始终运行，生产环境推荐使用
        volumes:
            # :号左边是宿主机的nginx的文件路径，右边是nginx容器的文件路径
            - /mymkdir/softwore/docker/test/nginx/conf/nginx.conf:/etc/nginx/nginx.conf
            - /mymkdir/softwore/docker/test/nginx/conf/conf.d:/etc/nginx/conf.d
            - /mymkdir/softwore/docker/test/nginx/log:/var/log/nginx
            - /mymkdir/softwore/docker/test/nginx/html:/usr/share/nginx/html
        ports: # 宿主机与容器的端口映射关系
            - "8080:8080" # 左边宿主机端口:右边容器端口
        networks: # 配置容器连接的网络，引用顶级 networks 下的条目
            data_security:
                ipv4_address: 192.128.0.2
        privileged: true      # 这个必须要，解决nginx的文件调用的权限问题
    #后端
    my-web-pro1:	# 服务名称
        image: openjdk:8  # 创建容器时所需的镜像
        container_name: my-web-pro1 # 容器名称，默认为"工程名称_服务条目名称_序号"
        ports: # 宿主机与容器的端口映射关系
            - '8090:8090' # 左边宿主机端口:右边容器端口
        restart: "always" #重启策略，能够使服务保持始终运行，生产环境推荐使用
        volumes:
            - ./app:/app
        # jar 包名称必须改成你自己的
        command: java -Duser.timezone=GMT+8 -jar /app/app.jar
        #build: . #表示以当前目录下的Dockerfile开始构建镜像
        networks:	# 配置容器连接的网络，引用顶级 networks 下的条目
            data_security:
                ipv4_address: 192.128.0.3
        stdin_open: true #stdin_open相当于run命令中的-d
        tty: true #tty相当于run命令中的-i
#网络服务
networks:
    data_security:      # 自定义网络名字
        driver: bridge	  # 网络模式，默认为 bridge
        ipam:
            config:
                - subnet: 192.128.0.0/16           #自定义固定容器ip 实现容器间通讯，增强docker-compose项目可移植性

```

# 四、执行部署

```shell
#执行部署 建议使用-d后台执行
[root@MiWiFi-RA81-srv test]# docker-compose up -d
[+] Running 2/2
 ⠿ Container my-web-pro1    Started                                                                                         1.1s
 ⠿ Container my-nginx-pro1  Started
 #执行完成之后 查看容器是否启动
 [root@MiWiFi-RA81-srv test]# docker ps
 #部署失败执行删除所有容器继续重来
[root@MiWiFi-RA81-srv test]# docker rm -f $(docker ps -aq)
```

# 五、浏览器查看

![image-20230322214840203](https://chensh888.com:8090/file/blog/2023/20230322214843.png)

Docker Compose+nginx+jar部署

-  网络数据请求



# 一、WXML 模板语法

## 1、发起 GET 请求

调用微信小程序提供的 wx.request() 方法，可以发起 GET 数据请求，示例代码如下：

```
wx.request({
      url: 'http://localhost/ceshi',
      method:'GET',
      //拼接在URL后中
      parm:{
          name: '张三'
        },  
      data:{
        age: 18
      },
      success:(res)=>{
        console.log("成功!");
      },
      fail:(res)=>{
        console.log(res);
      },
    })
```

## 2、发起 POST请求

```
wx.request({
      url: 'http://localhost/ceshi',
      method:'POST',
      //拼接在URL后中
      parm:{
          name: '张三'
        },  
      data:{
        age: 18
      },
      success:(res)=>{
        console.log("成功!");
      },
      fail:(res)=>{
        console.log(res);
      },
    })
```

## 3、小程序中网络数据请求的限制

出于安全性方面的考虑，小程序官方对数据接口的请求做出了如下

两个限制：

① 只能请求 HTTPS 类型的接口

② 必须将接口的域名添加到信任列表中



**注**:跳过 request 合法域名校验的选项，仅限在开发与调试阶段使用！

![image-20230213143426238](https://chensh888.com:8090/file/blog/2023/20230213143428.png)

## 4、配置 request 合法域名

需求描述：假设在自己的微信小程序中，希望请求 "自己的域名" 域名下的接口

配置步骤：登录微信小程序管理后台 -> 开发 -> 开发设置 -> 服务器域名 -> 修改 request 合法域名

注意事项：

① 域名只支持 https 协议

② 域名不能使用 IP 地址或 localhost

③ 域名必须经过 ICP 备案

④ 服务器域名一个月内最多可申请 5 次修改

## 5、关于跨域和Ajax的说明

跨域问题只存在于基于浏览器的 Web 开发中。由于小程序的宿主环境不是浏览器，而是微信客户端，所以小程序中不存在跨域的问题。   

Ajax 技术的核心是依赖于浏览器中的 XMLHttpRequest 这个对象，由于小程序的宿主环境是微信客户端，所以小程序中不能叫做“发起 Ajax 请求”，而是叫做“发起网络数据请求”。

微信小程序-GET、POST请求

-  WXML 模板语法
-  WXSS 模板样式
- 全局配置
- 页面配置



# 一、WXML 模板语法

## 1、数据绑定

① 在 data 中定义数据

② 在 WXML 中使用数据

### 1.在 data 中定义页面的数据

在页面对应的 .js 文件中，把数据定义到 data 对象中即可：

```
Page({

  /**
   * 页面的初始数据
   */
  data: {
  	info: 'Hello word!',
  	imgSrc: '/images/漩涡鸣人.jpg',//存储图片位置路径
	randomNum: Math.random().toFixed(2) //生成一个带两位随机数,
	count: 0 ,
    msg: '你好',
    type: 2,
    flag: false,
	arr1: ['苹果','香蕉','梨'],
    arr2: [{id:'1',name:'苹果'},{id:'2',name:'香蕉'}],
  }
})
```

### 2、在 WXML 中使用数据

把data中的数据绑定到页面中渲染，使用 **Mustache 语法**（双大括号）将变量包起来即可

Mustache 语法的主要应用场景如下：

- 绑定内容
- 绑定属性
- 运算（三元运算、算术运算等）

```
#使用
<view>{{ info }}</view>
#绑定属性
<image src="{{imgSrc}}" mode="widthFix" />
#三元运算
<view>
  {{ randomNum > 5?"随机数大于5":"随机数小于5"}}
</view>
```

## 2、 事件绑定

### 1.什么是事件

事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层产生的行为，反馈到逻辑层进行业务的处理。

![image-20230213103738055](https://chensh888.com:8090/file/blog/2023/20230213103742.png)

### 2.小程序常用事件

| 类型   | 绑定方式                  | 事件描述                                        |
| ------ | ------------------------- | ----------------------------------------------- |
| tap    | bindtap 或 bind:tap       | 手指触摸后马上离开，类似于 HTML 中的 click 事件 |
| input  | bindinput 或 bind:input   | 文本框的输入事件                                |
| change | bindchange 或 bind:change | 状态改变时触发                                  |

### 3.事件对象的属性列表

当事件回调触发的时候，会收到一个事件对象event，它的详细属性如下表所示：

|	属性	|	类型	|	说明|
| ---- | ---- | ---- |
|	type	|	String	|	事件类型|
|	timeStamp	|	Integer	|	页面打开到触发事件所经过的毫秒数|
|	target	|	object	|	触发事件的组件的一些属性值集合|
|	currentTarget	|	object	|	当前组件的一些属性值集合|
|	detail	|	object	|	额外的信息|
|	touches	|	Array	|	触摸事件，当前停留在屏幕中的触摸点信息的数组|
|	changedTouches	|	Array	|	触摸事件，当前变化的触摸点信息的数组|

### 4.target 和currentTarget 的区别

**target**是**触发该事件的源头组件**，而**currentTarget**则是**当前事件所绑定的组件**。举例如下：

![image-20230213105656116](https://chensh888.com:8090/file/blog/2023/20230213105657.png)

点击内部的按钮时，点击事件以冒泡的方式向外扩散，也会触发外层view 的tap 事件处理函数。

此时，对于外层的view 来说：

- e.target指向的是触发事件的源头组件，因此，e.target是内部的按钮组件
- e.currentTarget指向的是当前正在触发事件的那个组件，因此，e.currentTarget是当前的view 组件

### 5.bindtap的语法格式

在小程序中，不存在HTML 中的onclick 鼠标点击事件，而是通过tap 事件来响应用户的触摸行为。

①通过bindtap，可以为组件绑定tap 触摸事件，语法如下：

```
<view bindtap="outerHandler">
  <button type="primary">按钮</button>
</view>
```

②在页面的.js 文件中定义对应的事件处理函数，事件参数通过形参event（一般简写成e）来接收：

```
Page({
  
/**
 * 触发打印事件
 * @param {事件} e 
 */
  outerHandler(e){
    console.log(e);
  }
})
```

### 6.data中的数据赋值

```
Page({
    data: {
    count: 0
  },
  /**
   * 赋新值
   */
  changeCount(){
    this.setData({
      count: this.data.count + 1
    })
  }
})
```

### 7.事件传参

小程序中的事件传参比较特殊，不能在绑定事件的同时为事件处理函数传递参数。

可以为组件提供data-*自定义属性传参，其中* 代表的是参数的名字,例如:

```
<view bindtap="btnTapParm">
  <button type="primary" data-count="{{123}}">按钮</button>
</view>

#事件函数中需写入接受参数名
Page({
  
/**
 * 触发打印事件
 * @param {事件} e 
 */
  outerHandler(e){
    console.log(e);
  }
})
```

### 8.bindinput的语法格式

在小程序中，通过input 事件来响应文本框的输入事件，语法格式如下：

①通过bindinput，可以为文本框绑定输入事件：

```
<input bindinput="inputHandler"/>
<input type="text" value="{{ msg }}" bindinput="inputChange"/> 
```

②在页面的.js 文件中定义事件处理函数：

```
Page({
  /**
   * input 输入框事件函数
   */
  inputChange(e){
    console.log(e.detail.value);
  },
   /**
   * input 输入框事件函数 赋新值
   */
  inputChange(e){
    this.setData({
      msg: e.detail.value
    })
  },
})
```

### 9.条件渲染

1. **wx:if**

   ```
   <view wx:if="{{type ===1}}">男</view>
   <view wx:elif="{{type ===2}}">女</view>
   <view wx:else>其他</view>
   
   # 结合<block> 使用wx:if
   如果要一次性控制多个组件的展示与隐藏，可以使用一个<block></block>标签将多个组件包装起来，并在<block> 标签上使用wx:if 控制属性，示例如下：
   
   <block wx:if="{{true}}">
   <view>男</view>
   <view>女</view>
   </block>
   ```


2. **hidden** 

   ```
   
   <view hidden="{{flag}}">hidden条件为true隐藏</view>
   ```
   **wx:if**与**hidden**的对比

   ①运行方式不同

   - wx:if 以动态创建和移除元素的方式，控制元素的展示与隐藏

   - hidden 以切换样式的方式（display: none/block;），控制元素的显示与隐藏

   ②使用建议

   - 频繁切换时，建议使用hidden

   - 控制条件复杂时，建议使用wx:if搭配wx:elif、wx:else 进行展示与隐藏的切换
3. **wx:for**

   - 使用wx:for-index 可以指定当前循环项的索引的变量名

   - 使用wx:for-item 可以指定当前项的变量名
   - 使用wx:key 提高渲染的效率

   ```
   
   
   <view wx:for="{{arr1}}" wx:key="*this">
     索引:{{index+1}},属性值:{{item}}
   </view>
   <view wx:for="{{arr2}}" wx:key="id" class="username">
     索引:{{index}},id:{{item.id}},name:{{item.name}}
   </view>
   ```

   

# 二、 模板样式

## 1. 什么是WXSS

WXSS (WeiXin Style Sheets)是一套样式语言，用于美化WXML 的组件样式，类似于网页开发中的CSS。

## 2.WXSS和CSS的关系
WXSS 具有CSS 大部分特性，同时，WXSS 还对CSS 进行了扩充以及修改，以适应微信小程序的开发。与CSS 相比，WXSS 扩展的特性有：
- rpx尺寸单位

  > #1、rpx（responsive pixel）是微信小程序独有的，用来解决屏适配的尺寸单位。
  >
  > #2、rpx 的实现原理非常简单：鉴于不同设备屏幕的大小不同，为了实现屏幕的自动适配，rpx 把所有设备的屏幕，
  >
  > 在宽度上等分为750 份（即：当前屏幕的总宽度为750rpx）。
  >
  > ​	- 在较小的设备上，1rpx 所代表的宽度较小
  >
  > ​	- 在较大的设备上，1rpx 所代表的宽度较大
  >
  > 小程序在不同设备上运行的时候，会自动把rpx 的样式单位换算成对应的像素单位来渲染，从而实现屏幕适配。
  >
  > #3、**rpx** 与px之间的单位换算
  >
  > 在iPhone6 上，屏幕宽度为375px，共有750 个物理像素，等分为750rpx。则：
  >
  > 750rpx= 375px= 750 物理像素；
  >
  > 官方建议：开发微信小程序时，设计师可以用iPhone6作为视觉稿的标准。
  >
  > 开发举例：在iPhone6 上如果要绘制宽100px，高20px的盒子，换算成rpx单位，宽高分别为200rpx 和40rpx。
- @import 样式导入
  
  >  #1、什么是样式导入
  >
  > 使用WXSS 提供的@import 语法，可以导入外联的样式表。
  >
  > #2、@import 的语法格式
  >
  > @import 后跟需要导入的外联样式表的相对路径，用;表示语句结束。示例如下：
  >
  > ```
  > /** common.wxss **/
  > .username{
  >  color: red;
  > }
  > /** index.wxss **/
  > @import "/common/common.wxss";
  > input {
  >   border: 1px solid red;
  >   margin: 5px;
  >   padding: 5px;
  >   border-radius: 5px; /*圆角*/
  > }
  > ```
  >

## 3.全局样式和局部样式

**全局样式**

定义在app.wxss 中的样式为全局样式，作用于每一个页面。

**局部样式**

在页面的.wxss文件中定义的样式为局部样式，只作用于当前页面。

**注意**：

- 当局部样式和全局样式冲突时，根据就近原则，局部样式会覆盖全局样式

- 当局部样式的权重大于或等于全局样式的权重时，才会覆盖全局的样式

# 三、全局配置

**全局配置文件及常用的配置项**

小程序根目录下的 app.json 文件是小程序的全局配置文件。常用的配置项如下：

① pages;记录当前小程序所有页面的存放路径

② window;全局设置小程序窗口的外观

③ tabBar;设置小程序底部的 tabBar 效果

④ style;是否启用新版的组件样式

## 1、**全局配置 -** window

### 1. 小程序窗口的组成部分

<img src="https://chensh888.com:8090/file/blog/2023/20230213132409.png" alt="image-20230213132407513" style="zoom: 80%;" />

### 2.window 节点常用的配置项

|	属性名	|	类型	|	默认值	|	说明|
| ---- | ---- | ---- | ---- |
|	navigationBarTitleText	|	String	|	字符串	|	导航栏标题文字内容|
|	navigationBarBackgroundColor	|	HexColor	|	#000000	|	导航栏背景颜色，如 #000000|
|	navigationBarTextStyle	|	String	|	white	|	导航栏标题颜色，仅支持 black / white|
|	backgroundColor	|	HexColor	|	#ffffff	|	窗口的背景色|
|	backgroundTextStyle	|	String	|	dark	|	下拉 loading 的样式，仅支持 dark / light|
|	enablePullDownRefresh	|	Boolean	|	false	|	是否全局开启下拉刷新|
|	onReachBottomDistance	|	Number	|	50	|	页面上拉触底事件触发时距页面底部距离，单位为 px|

## 2、**全局配置 -** tabBar

### 1. 什么是 tabBar

tabBar 是移动端应用常见的页面效果，用于实现多页面

的快速切换。小程序中通常将其分为：

- 底部 tabBar

- 顶部 tabBar

![image-20230213140808945](https://chensh888.com:8090/file/blog/2023/20230213140811.png)

**注意**：

- tabBar中只能配置最少 2 个、最多 5 个 tab 页签

- 当渲染顶部 tabBar 时，不显示 icon，只显示文本

### **2. tabBar** 的个组成部分

①backgroundColor：tabBar 的背景色

②selectedIconPath：选中时的图片路径

③borderStyle：tabBar 上边框的颜色

④iconPath：未选中时的图片路径

⑤selectedColor：tab 上的文字选中时的颜色

⑥color：tab 上文字的默认（未选中）颜色

![image-20230213140854858](https://chensh888.com:8090/file/blog/2023/20230213140856.png)

### 3.tabBar节点的配置项
|	属性	|	类型	|	必填	|	默认值	|	描述
| ---- | ---- | ---- | ---- | ---- 
|	position	|	String	|	否	|	bottom	|	tabBar 的位置，仅支持 bottom/top
|	borderStyle	|	String	|	否	|	black	|	tabBar 上边框的颜色，仅支持 black/white
|	color	|	HexColor	|	否	|		|	tab 上文字的默认 (未选中) 颜色
|	selectedColor	|	HexColor	|	否	|		|	tab 上的文字选中时的颜色
|	backgroundColor	|	HexColor	|	否	|		|	tabBar 的背景色
|	list	|	Array	|	是	|		|	tab 页签的列表,最少 2个、最多 5个 tab

### 4.每个tab项的配置选项

|	属性	|	类型	|	必填	|	描述|
| ---- | ---- | ---- | ---- |
|	pagePath	|	String	|	是	|	页面路径，页面必须在 pages 中预先定义|
|	text	|	String	|	是	|	tab 上显示的文字|
|	iconPath	|	String	| 否 |	未选中时的图标路径;当 postion 为 top 时，不显示 icon|
|	selectedlconPath	|	String	| 否 |	选中时的图标路径;当 postion 为 top 时，不显示 icon|

# 四、页面配置

## 1、页面配置文件的作用

小程序中，每个页面都有自己的 .json 配置文件，用来对当前页面的窗口外观、页面效果等进行配置。

## 2、页面配置和全局配置的关系
小程序中，app.json 中的 window 节点，可以全局配置小程序中每个页面的窗口表现。  
如果某些小程序页面想要拥有特殊的窗口表现，此时，“页面级别的 .json 配置文件”就可以实现这种需求。

注意：当页面配置与全局配置冲突时，根据就近原则，最终的效果以页面配置为准。

## 3、页面配置中常用的配置项

|	属性	|	类型	|	默认值	|	描述|
| ---- | ---- | ---- | ---- |
|	navigationBarBackgroundColor	|	HexColor	|	#000000	|	当前页面导航栏背景颜色，如 #000000|
|	navigationBarTextStvle	|	String	|	white	|	当前页面导航栏标题颜色，仅支持 black / white|
|	navigationBarTitleText	|	String	|		|	当前页面导航栏标题文字内容|
|	backgroundColor	|	HexColor	|	#ffffff	|	当前页面霞凑豺妇洁柄剥鞍啊鞍搬记绷齿北居傲的背景色|
|	backgroundTextStyle	|	String	|	dark	|	当前页面下拉 loading 的样式，仅支持 dark / light|
|	enablePullDownRefresh	|	Boolean	|	FALSE	|	是否为当前页面开启下拉刷新的效果|
|	onReachBottomDistance	|	Number	|	50	|	页面上拉触底事件触发时距页面底部距离，单位为 px|