📋前言
最近在项目开发和学习的过程中,涉及到了vant ui(简称vant)
的使用,主要还是涉及到了card卡片和cell单元格
的使用,这个系列的文章简单记录一下这个实战过程和学习经历,这篇文章先介绍 vant ui入门与使用。
🎯什么是vant ui
官方地址:https://vant-contrib.gitee.io/vant/#/zh-cn/home
-
vant 是一个轻量、可定制的移动端组件库,于 2017 年开源。目前 vant 官方提供了 vue 2 版本、vue 3 版本和微信小程序版本,并由社区团队维护 react 版本和支付宝小程序版本。
-
vant ui 包含了按钮、输入框、表单、轮播图、导航栏、列表等常用界面元素,并支持自定义主题和按需加载。除此之外,vant ui 还包括了日历组件、城市选择器、图片上传等实用性组件。它的目标是提供一套高质量、实用性和易用性的组件库,加速开发者的移动端应用程序开发过程。
-
vant ui 拥有完整的中文文档,提供了详细的 api 文档、组件使用示例、主题定制和如何对组件库进行二次开发等信息。同时,vant ui 也拥有活跃的社区,在 github 上发布源代码并接受开发者的反馈和贡献,以使组件库不断更新和优化。
🎯快速上手
通过 npm 安装
在现有项目中使用 vant 时,可以通过 npm
进行安装:
# vue 3 项目,安装最新版 vant
npm i vant
# vue 2 项目,安装 vant 2
npm i vant@latest-v2
当然,你也可以通过 yarn
或 pnpm
进行安装:
# 通过 yarn 安装
yarn add vant
# 通过 pnpm 安装
pnpm add vant
通过 cdn 安装
使用 vant 最简单的方法是直接在 html 文件中引入 cdn 链接,之后你可以通过全局变量 vant 访问到所有组件。
这里就不详细描述了,本文以脚手架开发为主,具体 cdn 安装到官网查看。
🎯组件用法
组件注册
vant 支持多种组件注册方式,请根据实际业务需要进行选择。
全局注册
全局注册后,你可以在 app 下的任意子组件中使用注册的 vant 组件。
import { button } from 'vant';
import { createapp } from 'vue';
const app = createapp();
// 方式一. 通过 app.use 注册
// 注册完成后,在模板中通过 <van-button> 或 <vanbutton> 标签来使用按钮组件
app.use(button);
// 方式二. 通过 app.component 注册
// 注册完成后,在模板中通过 <van-button> 标签来使用按钮组件
app.component(button.name, button);
局部注册
局部注册后,你可以在当前组件中使用注册的 vant 组件。
import { button } from 'vant';
export default {
components: {
[button.name]: button,
},
};
我在测试项目中是这样配置的。
运行效果如下。
❗ 其他进阶用法到官网进行查询和学习吧,这里暂时不深入了解。
📝最后
这篇文章先介绍这么多了,简单学习和介绍了关于 vant ui入门与使用,具体详细的内容还请移步到官网进行查询和学习。下期内容记录一下 vant4 实战之card卡片与cell单元格
的使用。
发表评论