通过 npm 安装

在现有项目中使用 Vant 时,可以通过 npm 或 yarn 进行安装:

Vue 2 项目,安装 Vant 2:

  1. npm i vant -S

Vue 3 项目,安装 Vant 3:

  1. npm i vant@next -S

引入组件


方式一. 自动按需引入组件 (推荐)

babel-plugin-import 是一款 babel 插件,它会在编译过程中将 import 的写法自动转换为按需引入的方式。

安装插件

npm i babel-plugin-import -D

// 在.babelrc 中添加配置
// 注意:webpack 1 无需设置 libraryDirectory

  1. {
  2. "plugins": [
  3. ["import", {
  4. "libraryName": "vant",
  5. "libraryDirectory": "es",
  6. "style": true
  7. }]
  8. ]
  9. }

// 对于使用 babel7 的用户,可以在 babel.config.js 中配置

  1. module.exports = {
  2. plugins: [
  3. ['import', {
  4. libraryName: 'vant',
  5. libraryDirectory: 'es',
  6. style: true
  7. }, 'vant']
  8. ]
  9. };

// 接着你可以在代码中直接引入 Vant 组件
// 插件会自动将代码转化为方式二中的按需引入形式

  1. import { Button } from 'vant';

方式二. 手动按需引入组件

在不使用插件的情况下,可以手动引入需要的组件。

  1. import Button from 'vant/lib/button';
  2. import 'vant/lib/button/style';

( 目前采用了 方式三, 使用方式一配置后未生效)

方式三. 导入所有组件

Vant 支持一次性导入所有组件,引入所有组件会增加代码包体积,因此不推荐这种做法。

  1. import Vue from 'vue';
  2. import Vant from 'vant';
  3. import 'vant/lib/index.css';
  4. Vue.use(Vant);