Vant ElementVant Element
首页
指南
组件
示例
在线体验
GitHub
首页
指南
组件
示例
在线体验
GitHub
  • 介绍
  • 快速上手

快速上手

安装

vant-element 基于 vant 构建,需要确保项目中已安装 vant:

# 如果项目还没有 vant(vant-element 基于 Vant 2)
npm install vant@latest-v2 vant-element

如果你的项目已安装 vant,只需额外安装 vant-element 即可。

完整引入

import Vue from 'vue'
import Vant from 'vant'
import 'vant/lib/index.css'
import VantElement from 'vant-element'
import 'vant-element/dist/vant-element.css'

Vue.use(Vant)
Vue.use(VantElement)

完整引入会注册所有组件以及全局方法($message、$notify、$loading、$alert、$confirm、$prompt、$msgbox)。

按需引入

import Vue from 'vue'
import Vant from 'vant'
import 'vant/lib/index.css'
import { ElButton, ElDialog } from 'vant-element'
import 'vant-element/dist/vant-element.css'

Vue.use(Vant)
Vue.use(ElButton)
Vue.use(ElDialog)

按需引入时,需要单独调用 Vue.component() 注册使用的组件。全局方法($message 等)需通过完整引入或手动挂载。

可用组件一览

Basic 基础

Element 组件Vant 组件说明
Button 按钮van-button常用的操作按钮
ButtonGroup 按钮组多个 van-button 组合将多个按钮组合在一起
Icon 图标van-icon提供了一套常用的图标集合
Image 图片van-image + van-loading图片容器,支持懒加载
Layout 栅格布局van-row + van-col通过 24 列分栏创建布局
Card 卡片van-cell + van-cell-group将信息聚合在卡片容器中展示
Link 文字链接原生 a 标签在不同页面之间导航或跳转

Form 表单

Element 组件Vant 组件说明
Input 输入框原生 input + van-icon通过键盘输入内容
InputNumber 数字输入框van-stepper仅允许输入标准的数字值
Radio 单选框van-radio + van-radio-group一组备选项中进行单选
Checkbox 多选框van-checkbox + van-checkbox-group一组备选项中进行多选
Select 选择器van-popup + van-picker + van-search当选项过多时使用下拉菜单选择
Cascader 级联选择器van-popup + van-tabs + van-tag + van-search逐级查看并选择层级数据
CascaderPanel 级联面板van-tabs + van-tab + van-icon级联选择器的核心面板
TimeSelect 时间选择van-popup + van-picker固定选项的时间点选择
Autocomplete 自动完成van-popup + van-search + van-field带联想建议的输入组件
Switch 开关van-switch表示两种相互对立状态间的切换
Slider 滑块van-slider在固定区间内进行选择
DatePicker 日期选择器van-popup + van-datetime-picker用于选择日期
TimePicker 时间选择器van-datetime-picker用于选择时间
Upload 上传van-uploader文件上传组件
Rate 评分van-rate对事物进行快速评级
Form 表单van-form + van-field收集、校验、提交数据

Data 数据

Element 组件Vant 组件说明
Table 表格自定义实现 + van-checkbox展示多条结构化数据
List 列表自定义实现 + van-checkbox用于展示列表信息
ListPage 列表页van-pull-refresh + van-list带分页的列表组件
Descriptions 描述列表纯 Vue 实现以列表形式展示多个字段
Badge 徽标van-badge按钮或图标右上角的数字标记
Tag 标签van-tag用于标记和分类
Pagination 分页van-pagination数据量过多时分页展示
Skeleton 骨架屏van-skeleton加载过程中展示占位图形
Progress 进度条van-progress + van-circle展示操作进度
Empty 空状态van-empty没有数据时的占位提示
Carousel 走马灯van-swipe + van-swipe-item有限空间内循环展示
Calendar 日历van-calendar展示日期信息,支持事件标记

Navigation 导航

Element 组件Vant 组件说明
Tabs 标签页van-tabs + van-tab分隔不同类别的数据集合
Steps 步骤条van-steps + van-step引导用户按照流程完成
Collapse 折叠面板van-collapse + van-collapse-item通过折叠收纳内容区域
Dropdown 下拉菜单van-popover折叠次要操作到菜单中
Backtop 回到顶部van-icon + 自定义实现快速返回页面顶部

Feedback 反馈

Element 组件Vant 组件说明
Alert 提示自定义实现 + van-icon展示重要的提示信息
Message 消息提示van-toast从顶部出现的轻量提示
MessageBox 弹框van-dialog模态消息框,包含确认取消等操作
Notification 通知van-notify悬浮出现在页面角落的通知
Dialog 对话框van-dialog承载相关操作的弹出层
Popover 弹出框van-popover点击/悬浮触发的气泡弹出框
Loading 加载中van-toast(loading 模式)加载数据时显示动效
Tooltip 文字提示van-popover悬停或聚焦时显示额外提示
Popconfirm 气泡确认框van-popover + van-button点击元素后弹出确认气泡
Drawer 抽屉van-popup从屏幕边缘滑入的面板
Edit this page
最近更新: 2026/7/20 06:34
Contributors: zouhuaqiang
Prev
介绍