vue3-antdv4-dict

vue3-antdv4-dict是一款基于vue3、Ant Design Vue开发的一款字典包，实现了多个组件及方法，帮助大家更简单的使用字典数据及数据转化，使代码可读性更强，提升开发效率。

详细阅读官方使用文档题

历史

从vue2-element-dict、vue3-element-dict、vue2-vant-dict、vue3-vant4-dict多个字典包总结沉淀而成，放心使用。

公众号

抖音号

微信赞助

开发不易，如果对您有所帮助，可赞助作者，利于官网服务器运营。您的支持，是我继续努力的最大动力。

官方文档

https://www.xiaobu.host/vue3-antdv4-dict/

更新日志

0.1.1

1. 【优化】防抖和节流方法ts变量未声明问题

0.1.0

1. 【优化】v-close-dropdown自定义指令默认值优化, 新增classNameList，接受的参数是数组类型时则为配置classNameList，弹出框的类名选择器，需要加., 如[".xiaobu-popper"]。 如果是配置整个对象时，classNameList还支持字符串（多个时使用英文逗号分隔）

{
  isWindow: true, // 默认true 监听window窗口的滚动 布尔类型时为配置 isWindow
  distance: 50, // 默认滚动50像素后才关闭弹出框 数字类型时为配置distance
  classNameList: [".ant-select-dropdown", ".ant-picker-dropdown"] // 用于一些非ant-design-vue组件的弹出框，能够隐藏弹出框
}

2. 【优化】dict-dynamic-search组件表单是否可清除默认值优化，设置为默认可清除

3. 【优化】debounce方法新增一个参数，用于配置立即触发时，方法是否只触发最开始的一次。

4. 【优化】dict-auto-height组件优化，原先的excludes属性改为listenDoms表示需要监听高度变化的dom对象，新增excludeDoms属性，表示组件内部需要排除掉的dom对象，得出来的高度就会扣除这些dom对象的高度（margin不会被计算在内，因此这些dom尽量别使用margin）。存在偏差时可配置offset属性，表示需要扣除的高度，默认为0。

0.0.9

1. 【修复】校验方式使用compare时对日期格式数据也进行切换，运算符比较使用calculate时修复非${}包裹的元素不会进行日期时间戳转化的问题

2. 【新增】新增v-close-dropdown自定义指令，实现滚动时关闭弹出框，接受对象，布尔值，数字类型参数。

{
  isWindow: true, // 默认true 监听window窗口的滚动 布尔类型时为配置 isWindow
  distance: 50 // 默认滚动50像素后才关闭弹出框 数字类型时为配置distance
}

3. 【新增】新增dict-auto-height组件，用于自动计算元素高度撑满剩余空间，例如配合a-table的scroll.y属性实现表格高度自适应，使用时切记配置scroll.y属性高度为 获取到的高度 减去 表头高度

4. 【新增】新增dict-auto-complete-email邮箱输入组件

0.0.8

1. 【优化】修复dict-dynamic-components组配置showRuleType为validate且showRules配置校验多个字段时，如sex,name, name本身存在错误提示，sex改变时会移除name的校验的问题，重置按钮功能做了优化, picker组件宽度占比问题优化，range组件的默认Placeholder优化

2. 【新增】新增dict-dynamic-search组件,实现动态组件搜索功能

0.0.7

1.【优化】项目初始化时，若字典版本号与缓存不一致，将批量请求缓存中所有需通过接口获取的字典类型数据，并更新本地缓存。

2.【优化】修改动态组件默认渲染值由原来的formData改为组件配置里面的value值，null兜底

3.【优化】字典配置新增 delayTime 属性（单位：毫秒，默认值：null），用于配置延迟响应时间。当设置为非 null 值（如 300）时，启用防抖合并请求：在指定延迟时间内，将多个字典类型请求合并，延迟结束后统一调用批量接口一次性获取所有字典数据。

​ 注意：为了支持还有部分后端人员开发的接口不支持请求多个字典类型，此版本将delayTime设置为null，避免版本更新导致这些用户报错而不知所措。后续版本可能会把默认值改为300,请提前知悉。

4.【优化】JSON.parse(浏览器缓存数据)出错时捕获异常

5.【新增】新增暴露debounce防抖和throttle节流方法

6.【优化】新增timeout配置，解决字典数据请求方法请求超时问题

0.0.6

1. 【优化】日期格式兼容 ISO 8601 日期时间格式

2. 【修复】修复自定义日期方法时，传递日期格式无效问题

0.0.5

1. 【优化】修复项目按需引入时可能出现的报错问题

2. 【新增】新增descriptions组件

0.0.3

1. 【优化】select组件错误提示时，在form表单中无法被滚动到具体位置的问题修复

2. 【优化】动态组件新增配置滚动的配置 scrollOptions

{
  behavior: "smooth", //  "auto" 直接跳过去，不流畅； "smooth" 平滑滚动（最常用）；"instant"  瞬间滚动（和 auto 几乎一样）
  block: "center" // "start" 顶部对齐（和 top 一样; "center" 垂直居中（最舒服）; "end" : 底部对齐 "nearest": 就近对齐（浏览器自动选）
}

0.0.2

1. 【优化】table组件优化、动态组件滚动到错误位置优化、buttons组件样式优化、input和checkbox组件错误提示时在form表单中无法被滚动的问题修复

0.0.1

1. 【新增】首版代码