前言
我们在开发微信小程序时,设计和实现好用的用户界面无疑是至关重要的一步。但是微信小程序官方自带的 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模块』勾选选项,构建完成后,即可引入组件具体操作如下图:
六、使用
当在某个页面中调用
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 的官方地址,感兴趣的同学可以去官网更深入的了解。