更新日志

提示

成为 avue 的贡献者，快来一起完善文档吧文档源码每次更新版本时候，记得看更新日志，小心踩坑～。～如果你对 Avue 比较有兴趣，可以联系客服加入我们一起开发 Avue 生态

v3.9.5

2026-09-23

修复

修复日期范围组件配置 defaultTime: ['00:00:00', '23:59:59'] 时显示无效日期的问题，兼容字符串与 Date 类型 gitee_IKE8IS。
修复 Crud 调整列宽与拖拽排序冲突，以及拖拽后文本无法正常选中复制的问题 github_714。
修复 Crud 卡片模式跨页多选状态丢失的问题，配置 reserveSelection: true 时按稳定且唯一的 rowKey 保留选中记录 gitee_ICC574。
修复 Crud 普通字典列中 dicUrl、dicQuery、dicHeaders 的模板参数无法按当前行解析，以及不同行字典显示相互影响的问题；保持级联字段 {{key}} 取上级字段值的行为 gitee_IK6XHF。
修复 Crud / Dynamic 拖拽排序后数据顺序未同步、编辑内容错位的问题，拖拽后自动同步绑定数据，并兼容已有 sortableChange 回调 gitee_IDARY9。
修复 Crud 列配置面板关闭后触发状态未清理的问题。

优化

集中管理逐行字典列的识别逻辑，减少重复判断，保留静态字典、远程搜索、级联字典及手动 updateDic 的兼容行为。
补充逐行字典、卡片跨页多选、日期范围默认时间和 Dynamic 拖拽排序示例。
发布脚本同步 dev 到 master 时同步已删除文件，并在 Git 操作失败时停止执行。
重新生成 es、lib、dist 全量产物及压缩包，统一版本号为 3.9.5。

v3.9.4

2026-08-09

新增

新增 avue-captcha 多形态验证码，提供滑动拼图、文字点选、算术、旋转、图标点选、顺序点选、拖拽匹配、字母数字和轨迹滑动等验证方式；支持刷新、重置和主动校验在线例子。
新增 avue-filter-builder 高级筛选组件，通过逻辑关系和条件规则输出可直接转换为后端查询参数的数据在线例子。
新增 avue-file-manager 文件管理组件，支持文件夹维护、上传、搜索、重命名、移动、删除，以及图片、音视频、PDF、文本预览和下载在线例子。
新增本地 HTML 示例服务和二维码、Iframe 示例入口，便于独立预览组件示例。

优化

优化 Flow 的画布、节点连线与交互样式；Video 的录制、预览和状态反馈；Login 的表单标签与交互状态。
优化 Article、Chat、Comment 的内容安全渲染和展示体验；Contextmenu 的定位、层级和菜单样式。
Draggable 新增缩放、网格吸附、边界约束能力，并修复内容超出拖拽框的问题；Sign 优化签名画板交互与样式。
优化 License 凭证生成与导出体验；Watermark 实例隔离和自动恢复；Clipboard 的降级复制与状态恢复。
优化 Print 的内容和资源加载，并恢复函数式调用兼容；Screenshot 增强导出与错误反馈；Excel 导入导出增强错误处理和使用体验。
补充 Clipboard、Export、Print、Screenshot、Video、Watermark 等工具插件的 TypeScript 类型声明。

移除

移除 avue-card 组件，建议改用数据展示组件或 Element Plus 的 el-card。
移除旧 avue-verify 组件，验证码场景请迁移至 avue-captcha。

v3.9.3

2026-08-04

新增

新增 avue-input-otp 一次性密码输入组件，支持独立使用，以及 Form / Crud 中通过 type: 'otp' 或 type: 'input-otp' 配置；提供长度、掩码、字符校验、分隔符和完成事件等能力在线例子。
新增 avue-qrcode 二维码组件，支持 Canvas / SVG 渲染、容错等级、中心图标、状态遮罩及通过 toDataURL 导出二维码在线例子。
新增 avue-iframe 嵌入页面组件，支持加载、超时、错误、空状态，以及 reload、focus、postMessage 和 message 事件在线例子。
Form 字段提示框支持通过 Enter、NumpadEnter 键触发。

优化

优化字典请求管理和异步字典加载逻辑，未配置地址时安全返回空字典，并增强请求异常处理。
统一图标组件渲染，优化 Tabs 标签渲染逻辑。
Crud 打印按钮增加加载态，打印时自动排除操作列；Excel 导出优化表头、边框、斑马纹、列宽、自适应行高和筛选体验。
Crud 列配置面板重构为可拖拽气泡面板，支持批量显隐、固定、筛选、排序、取消和恢复列状态。
Crud 搜索与卡片视图按钮会高亮当前显示状态；已选行提示优化为可访问的状态提示，并向 tip 插槽提供选中行和数量。
更新示例 API 基础地址与协议格式。

修复

修复 Excel 导出时隐藏列仍可能参与导出的问题。
修复恢复 Crud 列状态时可能丢失部分列配置的问题。

v3.9.2

2026-06-18

新增

新增 optionValidate 配置校验能力，默认在 Form、Crud 初始化时输出配置 warning，也可通过全局 app.use(Avue, { optionValidate: false }) 或单个 option.optionValidate = false 关闭。
新增 validateOption、warnOption 全局工具方法，支持手动校验 option 配置并输出结构化提示在线例子。
Crud 新增列状态持久化能力，配置 columnStateKey 后可保存列显隐、冻结、筛选、排序和列宽，支持 localStorage / sessionStorage 以及自定义读写方法在线例子。
Crud 新增 column-state-change、column-state-reset 事件和 resetColumnState 方法，便于监听或重置列配置。
Crud 新增 getHalfSelectionRows 方法，支持获取树表半选行在线例子。
新增本地示例中心、Option 编辑器、配置校验、配置差异对比和页面代码生成器等在线测试工具在线例子。

优化

Crud 列拖拽排序回调补充当前列参数，并与列状态持久化联动保存顺序。
Crud 虚拟滚动方法初始化逻辑统一收敛，scrollTo、scrollToTop、scrollToLeft、scrollRow 等表格方法可统一转发。
Select 组件新增 endReached 回调和 end-reached 事件，适配虚拟选择器滚动到底部场景。
Cascader 组件透传 virtualScroll、fitInputWidth、height、itemSize 属性。
Date 组件透传 singlePanel 属性。

修复

修复插件初始化时上传回调继承逻辑，避免非上传字段误挂载上传钩子。
修复 Rollup 动态导入打包配置问题。

v3.9.0

2026-04-27

注意

本版本属于工程化大更新，重点覆盖 TypeScript 能力、构建链路、发布产物与示例资源结构。
package.json 入口由 lib/avue.min.js 调整为 lib/avue.js，样式引入路径统一为 @smallwei/avue/lib/index.css。
peerDependencies 新增 @element-plus/icons-vue，使用时请确认项目已正确安装。
es/avue.mjs 与 es/avue.min.mjs 已移除，ESM 场景请改用新的标准导出方式与产物入口。

新增

新增并完善 TypeScript 模块声明，补充 shims-vue.d.ts、路径别名声明以及更完整的组件、插件、工具函数类型提示。
新增更完整的构建产物结构，补充 lib/index.js、es/index.mjs、lib/index.css、es/index.css 以及 browser locale 多语言输出。
新增本地 examples/cdn 资源目录，统一管理示例依赖，降低外部 CDN 波动对示例运行的影响。

优化

源码入口全面切换为 TypeScript，核心模块、插件、工具函数及 UI 入口完成 .js 到 .ts 迁移，提升类型约束与维护效率。
构建工具链切换并收敛到 Rollup 方案，统一 lib、es、dist 输出结构，优化发布包组织方式。
扩展 tsconfig.json 中的路径配置，细化 Avue 安装选项、全局属性、组件导出和工具函数的类型定义。
示例页面统一改为本地相对资源路径，图片资源迁移到 examples/images，示例依赖加载方式更加一致。
更新依赖声明与锁文件，整理 dependencies 和 peerDependencies 结构，修正包入口与样式引用路径。
重构 README 文档，补充环境要求、安装方式、快速开始、全局配置、组件清单、贡献说明与本地开发命令。
移除自动版本发布与部署脚本，简化项目结构与发布维护流程。

修复

修复若干bug

v3.8.2

2026-03-27

新增

新增 InputCron 组件，支持 Cron 表达式可视化配置，并补充示例文档在线例子
日期时间组件新增 disabledHours、disabledMinutes、disabledSeconds 属性，支持在 Crud 中 type 为 datetime 时精确限制可选时间必须大于当前时间 gitee_IDO5QH
新增 TypeScript 类型声明文件，补充 AvueInstallOptions、插件实例以及 $AVUE、$axios、$uploadFun 等全局属性提示
新增 *.vue 模块声明，提升 Vue + TypeScript 项目中的组件导入兼容性