微信小程序-(十一)微信小程序开发引入Vant

本文最后更新于:April 2, 2022 pm

微信小程序,小程序的一种,英文名Wechat Mini Program,是一种不需要下载安装即可使用的应用,它实现了应用“触手可及”的梦想,用户扫一扫或搜一下即可打开应用。也体现了“用完即走”的理念,用户不用关心是否安装太多应用的问题。应用将无处不在,随时可用,但又无需安装卸载。对于开发者而言,微信小程序开发门槛相对较低,难度不及APP,能够满足简单的基础应用,适合生活服务类线下商铺以及非刚需低频应用的转换。

目录

Vant官方文档

安装Vant组件库

  • 初始化npm
1
npm init -y
  • 安装Vant
1
npm i @vant/weapp -S --production
  • 将 app.json 中的 "style": "v2" 去除,小程序的新版基础组件强行加上了许多样式,难以覆盖,不关闭将造成部分组件样式混乱。
  • 修改 project.config.json

开发者工具创建的项目,miniprogramRoot 默认为 miniprogrampackage.json 在其外部,npm 构建无法正常工作。

需要手动在 project.config.json 内添加如下配置,使开发者工具可以正确索引到 npm 依赖的位置。

1
2
3
4
5
6
7
8
9
10
11
12
13
{
...
"setting": {
...
"packNpmManually": true,
"packNpmRelationList": [
{
"packageJsonPath": "./package.json",
"miniprogramNpmDistDir": "./miniprogram/"
}
]
}
}

注意: 由于目前新版开发者工具创建的小程序目录文件结构问题,npm构建的文件目录为miniprogram_npm,并且开发工具会默认在当前目录下创建miniprogram_npm的文件名,所以新版本的miniprogramNpmDistDir配置为'./'即可

  • 构建npm 包

打开微信开发者工具,点击 工具 -> 构建 npm,并勾选 使用 npm 模块 选项,构建完成后,即可引入组件。

实现API Promise化

安装

小程序中,实现API Promise化主要依赖于 miniprogram-api-promise 第三方的npm包。

  • 安装
1
npm install --save miniprogram-api-promise

安装完成后,还需要构建npm包。打开微信开发者工具,点击 工具 -> 构建 npm,并勾选 使用 npm 模块 选项,构建完成后,即可使用。

使用

在小程序入口文件中(app.js),只需要调用一次promisifyAll()方法。即可实现异步API
的Promise化。

1
2
3
4
// app.js
import {promisifyAll} from 'miniprogram-api-promise'
const wxp = wx.p = {}
promisifyAll(wx,wxp)

调用Promise化之后的异步API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// pages/message/message.js
Page({
async GetIF(){
const res = await wx.p.request({
method: 'GET',
url: 'https://www.escook.cn/api/get',
data:{
name:'zs',
age: 20
}
})
console.log(res);
}
})

可以先自行不添加方法前的async和请求前的await,发送请求查看res是什么;然后再加上再看res是什么。