目录
一.安装
1.通过npm安装
2.通过 CDN 安装
3.通过脚手架安装
二.组件引入方式
方式一. 自动按需引入组件 (推荐)
方式二. 手动按需引入组件
方式三. 导入所有组件
三.组件注册
1.全局注册
2.局部注册
一.安装
1.通过npm安装
# Vue 2 项目,安装 Vant 2:
npm i vant -S# Vue 3 项目,安装 Vant 3:
npm i vant@next -S
2.通过 CDN 安装
<!-- 引入样式文件 -->
<linkrel="stylesheet"href="https://cdn.jsdelivr.net/npm/vant@2.12/lib/index.css"
/><!-- 引入 Vue 和 Vant 的 JS 文件 -->
<script src="https://cdn.jsdelivr.net/npm/vue@2.6/dist/vue.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/vant@2.12/lib/vant.min.js"></script><script>
3.通过脚手架安装
# 安装 Vue Cli
npm install -g @vue/cli# 创建一个项目
vue create hello-world# 创建完成后,可以通过命令打开图形化界面在图形化界面中,点击 依赖 -> 安装依赖,然后将 vant 添加到依赖中即可。
二.组件引入方式
方式一. 自动按需引入组件 (推荐)
# 安装插件
npm i babel-plugin-import -D
// 在.babelrc 中添加配置
// 注意:webpack 1 无需设置 libraryDirectory
{"plugins": [["import", {"libraryName": "vant","libraryDirectory": "es","style": true}]]
}
// 对于使用 babel7 的用户,可以在 babel.config.js 中配置
module.exports = {plugins: [['import', {libraryName: 'vant',libraryDirectory: 'es',style: true}, 'vant']]
};
// 接着你可以在代码中直接引入 Vant 组件
方式二. 手动按需引入组件
import Button from 'vant/lib/button';
import 'vant/lib/button/style';
方式三. 导入所有组件
import Vue from 'vue';
import Vant from 'vant';
import 'vant/lib/index.css';Vue.use(Vant);
Tips: 配置按需引入后,将不允许直接导入所有组件。
三.组件注册
1.全局注册
全局注册后,你可以在 app 下的任意子组件中使用注册的 Vant 组件。import Vue from 'vue';
import { Button } from 'vant';// 方式一. 通过 Vue.use 注册
// 注册完成后,在模板中通过 <van-button> 或 <VanButton> 标签来使用按钮组件
Vue.use(Button);// 方式二. 通过 Vue.component 注册
// 注册完成后,在模板中通过 <van-button> 标签来使用按钮组件
Vue.component(Button.name, Button);
2.局部注册
局部注册后,你可以在当前组件中使用注册的 Vant 组件。import { Button } from 'vant';export default {components: {[Button.name]: Button,},
};
四.使用,以button按钮为例
在入口文件先引入
import { Button } from 'vant'; Vue.use(Button);
就可以在子组件里面使用了,在子组件里面使用时如下图:
<van-button type="primary">主要按钮</van-button>
<van-button type="info">信息按钮</van-button>
<van-button type="default">默认按钮</van-button>
<van-button type="warning">警告按钮</van-button>
<van-button type="danger">危险按钮</van-button>