简单介绍
vue3-vant4-dict 是一个基于 vue3 + vant4 的字典包,他集成vant4众多组件,实现了移动端中常用表单组件的封装,能够让您一行代码就可以实现一个复杂的表单项。
v1.1.0版本开始还封装了动态组件,实现根据数据动态渲染组件,支持纯JSON格式数据渲染,兼容插槽、表单联动和校验功能。
简单示例
使用vant4组件库实现一个性别选择时,您需要用到van-field、van-popup、van-picker等组件,并需要调用获取字典数据接口,导致单单一个性别选择就得上百行代码。
使用了vue3-vant4-dict后,您只需要一行代码就可以实现性别选择的功能。
vue
<dict-select label="性别" v-model="sex" dict-type="SEX" clearable placeholder="请选择" />复制成功


优势
- 一次配置即可生效,后续仅需传递字典类型,便能轻松获取对应字典数据
- 配置项丰富全面,可兼容后端返回的所有字典数据格式及入参要求
- 支持字典数据缓存机制,有效避免重复请求,降低资源消耗
- 实现字典数据版本化管理,可自动更新字典数据(需后端支持),免去频繁清除浏览器缓存的操作
- 支持本地字典数据配置,满足离线场景或定制化数据需求
- 内置诸多常用组件,含选项组件(含日期相关)、按钮、标签等,且兼容所有已使用的 vant4 组件配置
- 内置字典转化、数据脱敏、日期格式化等实用工具方法
- 所有选项组件打开弹窗时,若存在选中值,将自动定位至已选值所在位置
- 支持自定义组件前缀配置,既能契合个人使用偏好,也可有效避免项目内组件命名冲突
- 所有选项组件均支持配置 clearable 属性,快速实现数据可清除功能

