小程序引入vant-weappy的正确姿势
前言
在小程序项目开发中,经常需要运用到这样或者那样的组件,但是小程序基础库中的那些组件我已无力吐槽,文档有时也不是很清晰,在这样的情况下,还是要找到适合我们的好用的,文档又清晰的,体验又很好的小程序库,vant-weappy来了
一、直接引入dist
(1)直接去该地址下载项目,https://github.com/youzan/vant-weapp,把dist文件进入你的小程序工程中。
(2)在 json 文件中配置button组件,修改路径:
{
"usingComponents": {
"van-button": "/dist/button/index"
}
}
(3)组件使用
<vant-button type="default">默认按钮</van-button>
二、npm引入组件
(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/"
}
]
}
}
注意: 由于目前新版开发者工具创建的小程序目录文件结构问题,npm构建的文件目录为miniprogram_npm,并且开发工具会默认在当前目录下创建miniprogram_npm的文件名,所以新版本的miniprogramNpmDistDir配置为’./'即可
(4)步骤四 构建 npm 包
打开微信开发者工具,点击 工具 -> 构建 npm,并勾选 使用 npm 模块 选项,构建完成后,即可引入组件。
(5)使用
引入组件
以 Button 组件为例,只需要在app.json或index.json中配置 Button 对应的路径即可。
所有组件文档中的引入路径均以 npm 安装为例,如果你是通过下载源代码的方式使用 @vant/weapp,请将路径修改为项目中 @vant/weapp 所在的目录。
// 通过 npm 安装
// app.json
"usingComponents": {
"van-button": "@vant/weapp/button/index"
}
使用组件
引入组件后,可以在 wxml 中直接使用组件
<van-button type="primary">按钮</van-button>