微信小程序使用 Vant Weapp 组件库教程

在微信小程序项目中使用 Vant 组件库(Vant Weapp)主要包括以下几个步骤:


1. 初始化项目并安装 Vant Weapp

  1. 初始化 npm

    在项目根目录下运行以下命令,生成 package.json

    bash 复制代码
    npm init -y
  2. 安装 Vant Weapp

    执行以下命令安装 Vant Weapp:

    bash 复制代码
    npm i @vant/weapp -S --production

2. 修改项目配置

  1. 移除 app.json 中的 "style": "v2"

    避免小程序基础组件样式冲突:

    json 复制代码
    {
      "style": "v2"  // 删除这一行
    }
  2. 调整 project.config.json(可选)

    确保 miniprogramRoot 正确指向小程序目录(如 ./),避免 npm 构建失败:

    json 复制代码
    {
      "setting": {
        "packNpmManually": true,
        "packNpmRelationList": [
          {
            "packageJsonPath": "./package.json",
            "miniprogramNpmDistDir": "./"
          }
        ]
      }
    }

3. 构建 npm 并启用 npm 模块

  1. 在微信开发者工具中构建 npm

    • 点击 工具构建 npm
    • 确保勾选 使用 npm 模块(新版本默认支持,已无此选项)
  2. 检查构建结果

    构建成功后,项目目录下会生成 miniprogram_npm 文件夹,包含 Vant 组件。


4. 引入并使用 Vant 组件

  1. 全局引入(推荐少量高频组件)

    app.json 中配置:

    json 复制代码
    "usingComponents": {
      "van-button": "@vant/weapp/button/index"
    }
  2. 局部引入(按需引入)

    在页面的 index.json 中配置:

    json 复制代码
    "usingComponents": {
      "van-button": "@vant/weapp/button/index"
    }
  3. 在 WXML 中使用

    html 复制代码
    <van-button type="primary">主要按钮</van-button>

5. 特殊组件(如 Toast、Dialog)的注意事项

  • Toast 组件 需要在 wxml 中添加节点:

    html 复制代码
    <van-toast id="van-toast" />

    并在 JS 中调用:

    javascript 复制代码
    Toast('提示内容');

6. 其他注意事项

  • 版本兼容性:确保微信开发者工具版本 ≥ 2.2.10。
  • 样式覆盖 :使用 externalClasses 定义外部样式类。
  • 官方文档 :详细 API 参考 Vant Weapp 官方文档
  • 温馨提示:如果构建npm 始终不成功,可以在微信开发者工具中,先清除缓存(工具->清除缓存),重新打开项目,重新构建 npm。

总结

以上步骤涵盖了 Vant Weapp 的安装、配置和使用。如需更详细的示例或特定组件的用法,可查阅官方文档或参考相关教程。

相关推荐
zoahxmy092912 小时前
微信小程序 request 流式数据处理
微信小程序
人人题13 小时前
汽车加气站操作工考试答题模板
笔记·职场和发展·微信小程序·汽车·创业创新·学习方法·业界资讯
曲江涛15 小时前
微信小程序 webview 定位 并返回
微信小程序·小程序
weixin_4404705015 小时前
部署Dify接入微信验证反代根目录创建一个文件通过微信小程序验证
微信小程序·腾讯云
276695829216 小时前
美团民宿 mtgsig 小程序 mtgsig1.2 分析
java·python·小程序·美团·mtgsig·mtgsig1.2·美团民宿
web_Hsir17 小时前
uniapp 微信小程序 使用ucharts
微信小程序·小程序·uni-app
web_Hsir17 小时前
Uniapp 实现微信小程序滑动面板功能详解
vue.js·微信小程序·uni-app
fakaifa18 小时前
beikeshop多商户跨境电商独立站最新版v1.6.0版本源码
前端·小程序·uni-app·php·beikeshop多商户·beikeshop跨境电商
Angus-zoe18 小时前
微信小程序唤起app
微信小程序·小程序