Vant是一个轻量、可定制的高颜值移动端UI组件库,于 2017 年开源,目前Vant 官方提供了 Vue 2 版本、Vue 3 版本和微信小程序版本,并由社区团队维护 React 版本和支付宝小程序版本。
Vant官网:https://vant-ui.github.io/
Vant简介
Vant是一个轻量、可靠的移动端Vue组件库,由有赞前端团队开发设计并维护。它提供了一系列高质量Vue组件,能够帮助开发者快速构建移动端应用界面。并且支持通过主题定制组件的样式,满足不同项目的需求。
Vant特色
🚀 性能极佳,组件平均体积小于 1KB(min+gzip)
🚀 80+ 个高质量组件,覆盖移动端主流场景
🚀 零外部依赖,不依赖三方 npm 包
💪 使用 TypeScript 编写,提供完整的类型定义
💪 单元测试覆盖率超过 90%,提供稳定性保障
📖 提供丰富的中英文文档和组件示例
📖 提供 Sketch 和 Axure 设计资源
🍭 支持 Vue 2、Vue 3 和微信小程序
🍭 支持 Nuxt 2、Nuxt 3,提供 Nuxt 的 Vant Module
🍭 支持主题定制,内置 700+ 个主题变量
🍭 支持按需引入和 Tree Shaking
🍭 支持无障碍访问(持续改进中)
🍭 支持深色模式
🍭 支持服务器端渲染
🌍 支持国际化,内置 30+ 种语言包
Vant使用说明
方法一. 常规用法
下面是使用 Vant 组件的用法示例:
import { createApp } from 'vue';
// 1. 引入你需要的组件
import { Button } from 'vant';
// 2. 引入组件样式
import 'vant/lib/index.css';
const app = createApp();
// 3. 注册你需要的组件
app.use(Button);
Vant 支持多种组件注册方式,除了在 app 上全局注册组件,你也可以选择其他的方式,比如局部注册,详见 组件注册 章节。
方法二. 按需引入组件样式
在基于 Rsbuild、Vite、webpack 或 vue-cli 的项目中使用 Vant 时,可以使用 unplugin-vue-components 插件,它可以自动引入组件。
Vant 官方基于 unplugin-vue-components 提供了自动导入样式的解析器 @vant/auto-import-resolver,两者可以配合使用。
相比于常规用法,这种方式可以按需引入组件的 CSS 样式,从而减少一部分代码体积,但使用起来会变得繁琐一些。如果业务对 CSS 的体积要求不是特别极致,我们推荐使用更简便的常规用法。
更多使用方法,可以参考Vant 官网教程。