步骤一 通过 npm 安装
1.新建小程序,选择目录
2.使用npm构建vant,使用powershell(windows直接使用任务栏搜索框搜索就可以)打开小程序目录如:
#进入到工作目录 cd "D:\coding\weixinapp\vantdemo001" #初始化项目会生成package.json npm init -y #安装package中的库 npm install #安装vant/weapp npm i @vant/weapp -S --production
执行效果如下(可能会有差异,初次构建和n次不一样)
步骤二 构建 npm 包
打开微信开发者工具,点击 工具 -> 构建 npm,并勾选 使用 npm 模块 选项,构建完成后,即可引入组件
构建npm前后目录对比
步骤三 修改 tsconfig.json
如果你使用 typescript 开发小程序,需要在 tsconfig.json 中增加如下配置,防止 npm 构建后 tsc 编译报错
请将path/to/node_modules/@vant/weapp
修改为项目中 @vant/weapp 所在的目录
{ "compilerOptions": { "baseUrl": ".", "paths": { "@vant/weapp/*": ["path/to/node_modules/@vant/weapp/dist/*"] } } }
步骤四 修改 app.json
将 app.json 中的 "style": "v2"
去除,小程序的新版基础组件强行加上了许多样式,难以去除,不关闭将造成部分组件样式混乱。
示例工程
我们提供了一个示例工程,示例工程会帮助你了解如下内容:
- 基于 Vant Weapp 搭建小程序应用
- 样式覆盖方案
使用
引入组件
以 Button 组件为例,只需要在app.json
或index.json
中配置 Button 对应的路径即可。如果你是通过下载源代码的方式使用 @vant/weapp,请将路径修改为项目中 @vant/weapp 所在的目录。
// 通过 npm 安装 // app.json "usingComponents": { "van-button": "@vant/weapp/button/index" }
// 通过下载源码使用 es6版本 // app.json "usingComponents": { "van-button": "path/to/@vant/weapp/dist/button/index" }
// 通过下载源码使用 es5版本 // app.json "usingComponents": { "van-button": "path/to/@vant/weapp/lib/button/index" }
使用组件
引入组件后,可以在 wxml 中直接使用组件
<van-button type="primary">按钮</van-button>