Vant 是有赞前端团队开源的一套轻量、可靠的移动端组件库。

历经八个月时长的开发，Vant 3.0 终于和大家正式见面咯。在本次迭代中，我们的主要工作是基于 Vue 3 重构整个代码仓库和周边生态，并发布 Vant 3.0、Vant Cli 3.0 和 Vant Use 1.0。

回顾

按照惯例，我们先简单回顾一下 Vant 开源至今的成绩：

  • 270 位开发者 参与了 Vant 和 VantWeapp 开发，并贡献了 4100 个 Pull Request
  • 7300 个 issue 被关闭，99.3% 的 issue 得到解决或答复
  • 站点月访问量 800 万次
  • CDN 月下载量 3 亿次

更新内容

Vant 3.0：全面拥抱 Vue 3 💪

Vue 3 带来了许多激动人心的新特性，比如 Composition API、emits Option 和 Teleport。在 Vant 3.0 中，我们全面拥抱了 Vue 3 带来的各种变化，完成下列改造：

  • 使用 Composition API 重构所有组件
  • 使用 Composition API 重写所有文档和示例
  • 组件增加 emits 选项，提供更好的事件提示
  • 移除所有 mixins，提升代码可读性
  • 所有弹窗类组件支持 teleport 属性

重构完成后，组件之间可以基于 Composition API 进行逻辑复用，代码的可压缩性也有所提升。与 Vant 2.12 版本进行对比，可以看到 Vant 3.0 的 JS 体积下降了 16.6%，Gzip 后体积下降至 67.5kb。

Vant 3.0 正式发布：全面拥抱 Vue 3 - 图1

新组件：Vant 2、Vant 3 同步供应

Vant 3.0 中包含 3 个全新的组件，分别是：

  • Badge 徽标：用于在右上角展示徽标数字或小红点。
  • Popover 气泡弹出框：弹出式的气泡菜单组件。
  • Cascader 级联选择器：用于多层级数据的选择，典型场景为省市区选择。

考虑到大部分开发者仍然在使用 Vue 2 进行开发，我们在 Vant 2 中同步实现了以上三个组件，大家可以升级到 Vant 2.12 版本进行使用。

Vant 3.0 正式发布：全面拥抱 Vue 3 - 图2

Vant Use：新伙伴 👬

Vant Use 从 Vant 中沉淀出的 Composition API 库。除了提供常用的 Composition API 外，Vant Use 也会将某些组件的逻辑抽离出来，让开发者在使用组件逻辑的同时，能够完全自定义组件的展现形式。

下面是一个简单的例子，我们将 CountDown 组件的倒计时逻辑抽象为 useCountDown 方法，功能与 CountDown 组件基本等价，但使用起来更加灵活，我们可以自定义倒计时的 UI 样式，或者通过 computed 对倒计时进行预处理。

Vant 3.0 正式发布：全面拥抱 Vue 3 - 图3

Vant Use 仍然处于早期阶段，在未来的演进过程中，我们会继续抽离 Vant 组件内部的通用逻辑，并下沉到 Vant Use 中。

Vant Cli 3.0：更新，更快 🚀

Vant Cli 是 Vant 底层的组件库构建工具，通过 Vant Cli 可以快速搭建一套功能完备的 Vue 组件库。在 Vant Cli 3.0 中，我们对所有底层依赖进行了大版本升级，在支持 Vue 3 的同时，提供更流畅的开发体验。

  • 升级 Vue 3、VueRouter 4、VueLoader 16
  • 升级 Webpack 5，开启持久缓存能力
  • 升级 Docsearch 3，全新的搜索框样式
  • 升级 TypeScript 4、ESLint 7

在创建 vant-cli 工程时，你可以自由选择基于 Vue 2 或者 Vue 3 进行组件库开发：

Vant 3.0 正式发布：全面拥抱 Vue 3 - 图4

Vant Demo：2 个新的示例工程

Vant Demo 是 Vant 官方提供的示例工程合集，在本次迭代中，我们新增了 2 个示例工程，分别演示：

  • 如何使用 Vue 3 + Vant 3 + Vue Cli 搭建应用
  • 如何使用 Vue 3 + Vant 3 + Vite 搭建应用

许多喜欢尝鲜的小伙伴已经在使用 Vite 进行开发了，在使用 Vite 的过程中，经常令大家困惑的一点是，如何在 Vite 中进行按需引入 Vant 组件。在 Vue Cli 中，我们可以通过 babel-plugin-import 插件实现按需引入，但在 Vite 中无法使用该插件。

其实在 Vite 中无须考虑按需引入的问题。Vite 在构建代码时，会自动通过 Tree Shaking 移除未使用的 ESM 模块。而 Vant 3.0 内部所有模块都是基于 ESM 编写的，天然具备按需引入的能力。现阶段遗留的问题是，未使用的组件样式无法被 Tree Shaking 识别并移除，后续我们会考虑通过 Vite 插件的方式进行支持。

开始尝鲜

目前，Vant 官网默认展示 Vant 2 的 API 文档，你可以通过官网右上角的版本切换按钮访问 Vant 3 的文档，也可以 👉 点此访问。

同时，Vant 的 npm latest 标签也保持在 v2 版本，这意味着使用 npm install vant 命令仍会安装 Vant 2，而安装 Vant 3 需要使用 npm install vant@next 命令。在 Vue 的默认文档版本和 npm 标签切换为 v3 后，我们也会同步进行切换。

从现有 Vant 2 项目升级，请参考 🚀 升级指南。

下一步计划

未来 6 ~ 12 个月内，我们会保持 Vant 2 和 Vant 3 的功能同步更新。随着 Vue 3 的普及，我们会逐步降低 Vant 2 的维护频率，并将工作重心转移到 Vant 3 上。

另外，除了官方维护的 Vue 版本和微信小程序版本，Vant 也有由社区的小伙伴们发起和维护的 React 版本和支付宝小程序版本，欢迎大家一起参与建设 💪

不平凡的 2020 年即将过去，希望 Vant 能给大家的工作带来一点点的帮助，我们明年再会。