Vant 是一个轻量、可靠的移动端组件库。
安装
1、安装:在终端中执行npm i @vant/weapp -S --production
2、修改 app.json
将 app.json 中的
"style": "v2"
去除,小程序的新版基础组件强行加上了许多样式,难以覆盖,不关闭将造成部分组件样式混乱。
3、修改 project.config.json
开发者工具创建的项目,miniprogramRoot 默认为 miniprogram,package.json 在其外部,npm 构建无法正常工作。需要手动在 project.config.json 内添加如下配置,使开发者工具可以正确索引到 npm 依赖的位置。
{
...
"setting": {
...
"packNpmManually": true,
"packNpmRelationList": [
{
"packageJsonPath": "./package.json",
"miniprogramNpmDistDir": "./miniprogram/"
}
]
}
}
注意
:如果这一步报错Duplicate object key
,表示有重复的配置。在project.config.json
中按下ctrl+f
搜索上面两个配置,看是否已经存在,如果存在删除即可。
4、打开微信开发者工具,点击 工具 -> 构建 npm,并勾选 使用 npm 模块 选项,构建完成后,即可引入组件。
如果出现如下报错,不用担心,在根目录下新建一个miniprogram
文件夹再构建npm即可
使用
官方给的引入组件的方式是这样的
// 通过 npm 安装
// app.json
"usingComponents": {
"van-button": "@vant/weapp/button/index"
}
不过我这样引入会找不到,报错如下:
改成这样引入就可以正确使用了
"usingComponents": {
"van-button": "/miniprogram/miniprogram_npm/@vant/weapp/button/index"
}
在页面中使用按钮
<van-button type="primary">按钮</van-button>