五分钟学会在微信小程序中使用 vantUI 组件库

前言

我们在开发微信小程序时,设计和实现好用的用户界面无疑是至关重要的一步。但是微信小程序官方自带的 UI 组件库无法满足很多使用场景,这个时候就需要我们使用一些第三方的 UI 组件库。而 vant Weapp 作为一款优秀的前端 UI 组件库,可以帮助我们快速地构建漂亮而且易用的界面。在本文中,我将会介绍 vant Weapp 如何在微信小程序中安装、使用,以及它如何帮助我们构建高质量的微信小程序。


使用步骤

一、打开终端窗口

在微信开发者工具中,右击选择『在外部终端窗口中打开』,具体操作如下图:

在这里插入图片描述


二、初始化

输入初始化项目的命令生成 package.json 包,如果出现像下图让你选择时一路回车即可,当然你也可以以 npm init -y 的形式安装,具体操作如下图:

备注: -y 的含义你可以简单理解为 yes 的意思,在初始化的时候省去了敲回车的繁琐步骤。可根据自己需要选择哪一种安装方式。

npm init
npm init -y

在这里插入图片描述


二、安装依赖

在打开的命令窗口中依次输入下面的命令,具体操作如下图:

//直接安装
npm i --production
npm i vant-weapp -S --production
//淘宝镜像安装
cnpm i --production
cnpm i vant-weapp -S --production

在这里插入图片描述


四、修改 app.json 文件

app.json 文件中的 "style": "v2" 去除,原因是小程序的新版基础组件强行加上了许多样式,难以覆盖,不去除容易造成部分组件样式混乱。如下图:

在这里插入图片描述


五、构建 npm

在微信开发者工具左上角找到『工具』→ 『构建npm』,然后在微信开发者工具右上角找到『详情』→ 『使用npm模块』勾选选项,构建完成后,即可引入组件具体操作如下图:

扫描二维码关注公众号,回复: 14971414 查看本文章

在这里插入图片描述


六、使用

当在某个页面中调用 vant Weapp 的组件时,在 app.json 文件中添加配置即可,当然你也可以选择按需引入,在对应页面的 json 文件中配置,如下图:

  • 全局配置引入 ----- app.json

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

"usingComponents": {
    
    
   //需要组件引入即可
  "van-button": "./miniprogram_npm/vant-weapp/button/index"
}

在这里插入图片描述

  • 局部配置引入 ----- index.json

局部引入需要在页面的 json 文件里配置 usingComponents 选项,这种按需引入组件的方式可以很大程度上减少项目的压力,但缺点是只有当前页面可以使用该组件,其他页面不能使用。

{
    
    
  "usingComponents": {
    
    
    "van-button": "../../miniprogram_npm/vant-weapp/button/index"
  }
}

在这里插入图片描述


提示类组件使用

大家可能比较好奇,为什么要把提示类的组件单独拎出来说呢?这是因为,提示类组件的使用跟 button 这些组件的使用略有不同,一不小心就遇到问题了。下面我按照官方文档给大家操作一遍,如下图:

这里我给按钮绑定了一个点击事件,即点击按钮后出现轻提示

在这里插入图片描述

当我点击按钮

在这里插入图片描述

可以明显看到我们写好的事件触发轻提示并没有触发,甚至控制台还报错了,这是为什么呢?

在这里插入图片描述

在仔细查看过官方文档之后,发现类似的组件文档中有都有这么一段的代码,需要我们额外引入或者添加。

在这里插入图片描述

js 中引入并且在 wxml 文件中添加相关代码后

在这里插入图片描述


总结

微信小程序是一种新兴的应用形式,在这种应用中,vant Weapp 框架可以帮助开发者快速实现小程序页面的完成。同时 vant Weapp 通过大量实际项目的反馈和调整,达到了深度定制化的效果,可以帮助小程序开发者减轻很多工作负担,从而更加专注于业务逻辑的实现,也为小程序开发者提供非常好的开发体验。在实际应用中,我们可以深度挖掘 vant Weapp 组件库内部的潜力,将其与业务需求结合,从而实现更加高效、智能的小程序开发。最后附上 vant Weapp 的官方地址,感兴趣的同学可以去官网更深入的了解。

猜你喜欢

转载自blog.csdn.net/Shids_/article/details/130242694