微信小程序中使用vant组件库(超详细)

这篇具有很好参考价值的文章主要介绍了微信小程序中使用vant组件库(超详细)。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

前言

Vant是一个轻量、可靠的移动端组件库,于2017年开源。目前Vant官方提供了 Vue 2 版本、Vue 3 版本和微信小程序版本,并由社区团队维护 React 版本和支付宝小程序版本。
微信小程序版本的Vant组件库是Vant Weapp,其官方文档是 https://youzan.github.io/vant-weapp/#/home
我们废话不多说,直接进入主题,在微信小程序中使用Vant Weapp

Vant Weapp的安装与使用

1、安装 node.js

在使用 Vant Weapp 前,我们需要安装 node.js ,因为后面会用到 npm 指令。
下载网址:https://nodejs.org

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
下载长期维护版的 node.js 安装包,然后安装一路点击Next,注意勾选上 Add to PATH 即可。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
安装完成后测试node.js是否安装成功:
在cmd终端中输入 node -v 后回车显示版本号,表示安装成功!

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
备注:win+R 输入 cmd 然后回车即可打开终端

2、通过 npm 安装

首先,在终端中打开项目根目录(注意:云开发项目要打开根目录下的 miniprogram 目录)

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

接着,输入初始化项目的命令

npm init -y

然后通过 npm 指令安装 Vant Weapp

npm i @vant/weapp -S --production

备注:-y 的含义:yes的意思,在初始化的时候省去了敲回车的繁琐步骤

普通项目:
微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
云开发项目:
微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

命令执行成功后,可以看到项目多了几个文件

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

3、修改 app.json

将 app.json 中的 “style”: “v2” 去除,小程序的新版基础组件强行加上了许多样式,难以覆盖,不关闭将造成部分组件样式混乱。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

4、修改 project.config.json

由于开发者工具创建的小程序目录文件结构问题,npm 构建无法正常工作,需要在project.config.json 中修改如下配置(普通项目和云开发项目修改的内容略有不同):

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
关于修改 project.config.json 的详细内容,可见官方文档的快速上手中的步骤三

5、构建 npm 包

打开微信开发者工具,点击 工具 -> 构建 npm,并勾选 使用 npm 模块 选项,可见官方文档 快速上手 的 步骤四。新版的微信开发者工具中,详情 -> 本地设置中没有【使用 npm 模块】选项,则不用理会, 如果有则需要勾选。
微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

6、使用组件

你只需要在 app.json 或 你需要使用 vant 的页面中的 json 文件进行组件的注册即可使用了
这里涉及到注册组件的两种方式,后面会讲到。下面,以在 app.json 全局注册 button 组件为例:

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
注册引入组件后,在 wxml 中直接使用组件

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
可以看到使用成功了!

全局引入和局部引入

前面我们说到可以在 app.json 或 需要使用 vant 的页面中的 json 文件进行组件的注册这两种引入组件的方式,这里分别称之为 全局引入 和 局部引入。

全局引入

全局引入只需在 app.json 配置 usingComponents 选项即可引入组件,在所有页面中都可以使用引入的组件。这种方式的缺点是会给项目造成压力,建议当一个组件在很多页面都需要用到时,才使用全局引入。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
在任意的 wxml 页面都可以使用引入的组件

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

局部引入

在页面的 json 文件里配置 usingComponents 选项,这种按需引入组件的方式,我暂且称它为局部引入。这种方式,可以减少项目的压力,但是只有当前页面可以使用该组件,其他页面不能使用。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
在 my.wxml 中使用引入的组件

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

Toast 组件的使用

这里为啥要把 Toast 组件单独拎出来呢?这是因为,Toast 的使用跟 Button 这些组件的使用略有不同,一不小心就遇到问题了,下面介绍 Toast 组件的使用。
按照官方文档,我们在 json 和 js 文件添加如下代码:

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
这里给按钮绑定一个点击事件,即点击按钮后出现 Toast 提示

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm
在 json 和 js 文件添加对应代码后,发现出现警告,这是怎么回事呢?
仔细查看官方文档,发现文档中有一段 wxml 的代码。我们在 wxml 中添加对应代码就不会出现警告了!

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

小结一下,Toast 的使用,需要在 json、js、wxml 文件中添加代码,千万别忘了在 wxml 页面内添加对应的节点。另外,Dialog 弹出框、Notify 消息提示的使用也和 Toast 类似,详细使用可以查看官方文档。

官方文档 API 详解

我们在查看 Vant Weapp 官方文档时,会发现组件的 API 有 Props 参数、Events 事件、Slot 插槽、外部样式类这几种,下面简单介绍一下这几种组件 API

Props 参数

这个比较简单,看一下官方文档就懂了。以 button 组件为例,我们可以添加不同的参数,来实现需要的效果。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

Events 事件

Vant Weapp 给每个组件都提供了一些事件,方便我们实现组件的交互效果。以 Field 输入框为例,我们使用 bind:input 事件来打印当前的输入值。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

Slot 插槽

插槽是 vue 为组件的封装者提供的能力。允许开发者在封装组件时,把不确定的、希望由用户指定的部分定义为插槽。因为 vant 是基于 vue 的,所以 vant 沿用了 vue 的插槽。
以 Field 输入框为例,我们使用插槽自定义输入框尾部图标。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

外部样式类

在 vant 组件中,我们添加的 class 样式一般不能生效,需要自己定义外部样式类使用。下面以 Field 输入框为例,利用 label-class 来改变左侧文本的字体大小。

微信小程序使用vant,微信小程序,微信小程序,小程序,前端,npm

最后,我想说学习一个框架或组件库,官方文档是最好的工具。
以上是本人对微信小程序中使用 vant 组件库的一些见解,如有错误,欢迎指正!文章来源地址https://www.toymoban.com/news/detail-784250.html

到了这里,关于微信小程序中使用vant组件库(超详细)的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 微信小程序vant安装使用过程中遇到无法构建npm的问题

    官网地址,然而如果完全按照这个教程来,实际上是缺少步骤的,需要补充一些步骤(参考https://www.bilibili.com/video/BV1vL41127Er)

    2024年02月03日
    浏览(58)
  • 微信小程序Vant组件配置及使用

    Vant Weapp 官网文档:介绍 - Vant Weapp (gitee.io) Vant Weapp GitHub地址:youzan/vant-weapp: 轻量、可靠的小程序 UI 组件库 (github.com) 本教程使用下载代码方式引入vant组件 通过git下载vant源码 将vant源码路径下的 dist 文件夹复制到微信小程序项目中 将 app.json 下的 \\\"style\\\": \\\"v2\\\" 去除,微信小程序

    2024年02月13日
    浏览(77)
  • 原生微信小程序使用 wxs;微信小程序使用 vant-weapp组件

    在这里插入图片描述 操作顺序 :文档地址 如果使用 typescript 需要操作步骤3,否则不需要操作 2.1 在根目录下 操作 2.2 安装版本 2.3 构建包 - 详情-勾选使用 npm 2.4 使用 vant 组件

    2024年02月11日
    浏览(73)
  • 微信小程序安装和使用 Vant Weapp 组件库

    Vant 是一个轻量、可靠的移动端组件库,于 2017 年开源。 目前 Vant 官方提供了 Vue 2 版本、Vue 3 版本和微信小程序版本,并由社区团队维护 React 版本和支付宝小程序版本。 在小程序项目上安装Vant Weapp,(你的电脑应该有npm环境才行)。 win + R 输入 npm -version 查看一下 如果没有

    2024年02月16日
    浏览(73)
  • 微信小程序使用vant组件所出现的一些问题

    我在第一次使用vant小程序组件时,出现了不少问题 首先,我是跟随官方文档一步一步来做的,但当我构建npm时发生了一些报错 1.发生错误 Error: C:Users86198WeChatProjectsminiprogram-1package.json 未找到 2.发生错误 Error: C:Users86198WeChatProjectsminiprogram-1package.json 对应的 node_modules 不

    2024年01月23日
    浏览(54)
  • 微信小程序使用vant组件样式不生效的问题

    方案一: 官方文档有说明,将 app.json 中的 “style”: “v2” 去除,小程序的新版基础组件强行加上了许多样式,难以覆盖,不关闭将造成部分组件样式混乱。 方案二: 网上说了很多解决方案,例如: 1、可能是布局样式有冲突 推测可能是flex 布局 2、app.json中取消懒加载 …

    2024年02月11日
    浏览(76)
  • 微信小程序使用vant组件样式未生效解决办法

    1.删除小程序自带的样式 首先在app.json里面删除这一行 2.清除缓存 重新编译   3.重新构建npm 重新编译 在工具里面  

    2024年02月15日
    浏览(48)
  • 如何在微信小程序里面使用npm安装第三方插件(以安装vant ui为例)

    1.在cmd里或者是终端里,找到对应的项目,并执行下面的命令,用来初始化package.json文件。 2.勾选下图选项 3.执行下面的命令安装vant ui 然后你会发现多了一个node_modules文件, 里面存的就是第三方组件。 4.最后一步,每次安装完一个新的第三方插件都要执行“构建npm” 执行完

    2024年02月14日
    浏览(68)
  • 微信小程序使用vant组件的输入框搭配弹层选择器注意事项

    先看下页面代码: wxml js 效果: 点击: 选完确认: 在做这个效果的时候,输入框 van-field 必须得加入 readonly 这个只读属性,不然会导致用户手机触发默认键盘遮挡你的弹窗和选择器内容影响体验. 也不要用 disabled 来禁用输入框,样式会变成禁用状态下的样式很难改动,只需要设置为只

    2024年02月11日
    浏览(63)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包