Vue Amazing UI

Appearance

3.9.2

更新日志 ​

赞助

提示

如果你在使用过程中发现了问题、bug或希望贡献新功能 / 新组件，欢迎通过以下方式与我联系：

  • 问题反馈：前往 GitHub Issues 提交 issue，建议附上复现步骤或最小示例
  • 代码贡献：新功能、新组件、bug 修复及文档更新，请先阅读贡献指南，再向 main 分支发起 Pull Request
  • 直接联系：通过页面右下角邮箱地址与我直接沟通

3.9.2
2026-11-07
​

  • 优化 数字输入框 InputNumber 的空值语义：value / defaultValue 接受 null（undefined 仍表示非受控），清空输入时 change 与 update:value 上报 null（原为 undefined），空值步进按 0 起算，使用者文档同步属性与事件类型
  • 修复 日期选择器 DatePicker 与 时间选择器 TimePicker 的键盘与焦点：收起态 Enter 展开，展开态提交并收起，Esc 收起，Tab / Shift+Tab 在输入框与面板间进出，焦点移出即收起；键盘目标列的底色与选中项区分开，面板收起后清除，使用者文档同步键盘操作说明
  • 修复上述两个选择器的输入与禁用：手输非法文本、命中 disabledDate 的日期回填为已提交文本，同值选择不再重复派发 change，展开中切为禁用即收起且解除禁用不自行展开
  • 修复 日期选择器 DatePicker 的面板与范围形态：周 / 周范围选完月份回到周面板，十年面板恒标出视图日期所在十年，配置 disabledDate 时年 / 十年面板的悬浮预览不再卡顿；与 时间选择器 TimePicker 的范围形态下划线与面板箭头在容器宽度变化后不再错位
  • 优化浮层滚到边界的行为：日期与时间选择器的时间列、日期选择器的预设面板、标签页 Tabs 的「更多」下拉，滚到顶 / 底后继续滚动不再带动页面（与 选择器 Select 的面板一致）
  • 修复 滚动条 Scrollbar 的滑块显隐：指针在滚动区域外时，程序化滚动（如时间列展开时滚到选中项）不再点亮滑块并常驻；内容异步撑开后指针已在区域内时，滚动仍能正常点亮
  • 优化 轮播图 Carousel 的导航箭头：补轮廓暗晕与悬停提亮，亮色图片上更易辨认；关闭 loop 到达首 / 尾后该方向箭头置灰且不再响应点击
  • 更新使用者文档与贡献者文档
  • 组件库及文档代码优化

3.9.1
2026-11-06
​

  • 增强 滚动条 Scrollbar 的实例能力：getScrollData() 补 scrollLeft，由缓存快照改为调用时实时读取（未挂载时各项为 0），新增导出 ScrollbarExpose / ScrollDirection / ScrollbarScrollData 类型
  • 修复 滚动条 Scrollbar 的滚动行为：scroll / scrollend 在拖动滑块、scrollTo / scrollBy 及直接写 scrollLeft / scrollTop 时不再丢失（位置未变不派发、横纵同帧变化各派发一次，scrollend 不再受 autoHide / trigger 门控）；<KeepAlive> 切回后恢复滚动位置，滑块不再超出轨道长度、拖拽不再跳动，delay 运行期修改即时生效
  • 修复 级联选择 Cascader 虚拟滚动快速滚动（含触控板惯性）时列内出现整片空白
  • 修复 时间轴 Timeline 的自定义轴点：遮挡块不再强制圆角与内边距，图标 / 文字轴点不再露出圆环或方块边角；--timeline-head-bg 默认值不再写死在组件根上，页面底色与容器色不一致时可改由祖先元素覆盖
  • 重构 滚动监测 useScroll：改用 useScroll(target, options)，throttleDelay 移除（需要限流时在 onScroll 内自行处理），onScroll / onStop 与新增的 scrollEndDelay 移入 options；xScrollMax / yScrollMax 更名 maxX / maxY，旧 left / right / top / bottom（滚动方向）移除、方向改由新增的 direction 上报，新增到边界判断 atLeft / atRight / atTop / atBottom 与 start / stop / refresh
  • 更新使用者文档
  • 组件库及文档代码优化

3.9.0
2026-11-05
​

  • 重构 标签页 Tabs：items 属性与 TabsItem 类型移除，页签改用 TabPane 子组件描述（key 写在子组件，tab / content 插槽改为 tab 插槽与默认插槽，icon 由 tab 插槽承接）
  • 移除 centered 属性，改用 justifyContent: 'center'（card 下仅 center 生效，line 下溢出时不生效）；animated 默认值由 true 改为 false，需要动画时须显式开启
  • 新增 addable、TabPane 的 closable 与 tabBar / addIcon 插槽、tabClass / contentClass、add / close / tabClick 事件，页签可增删、页签头与类名自定义
  • 新增 beforeLeave、destroyInactiveTabPane 与 TabPane 的 displayDirective（if / show / show:lazy）：切换前可拦截，非激活面板的卸载时机可配置
  • 新增溢出收纳与 centerActiveTab：放不下的页签仍可滚动到达，完全滚出的收进「更多」下拉，激活项可滚动到导航区中间，滚动方向经 tabScroll 上报
  • 优化可访问性：补 tablist / tab / tabpanel 语义与方向键、Home / End 键盘导航
  • 更新使用者文档与贡献者文档
  • 组件库及文档代码优化

3.8.2
2026-11-04
​

3.8.1
2026-11-04
​

3.8.0
2026-11-04
​

  • 新增 分页 Pagination 的 bordered 属性与 showQuickJumper 的对象形态 { goButton }（传字符串即按钮文案），跳转框改为只接受数字、有按钮时失焦不自动跳转，并补充 PaginationQuickJumper 类型导出
  • 修复 分页 Pagination 的省略号按钮类名拼写（pagintion-jump-prev / pagintion-jump-next → pagination-jump-prev / pagination-jump-next，按旧类名覆盖样式的需同步改名）与页码越界：total / page 越界时按有效页码渲染，update:page / change 也返回有效页码
  • 修复 表格 Table 分页在数据量或 total 缩小后表体为空：改按有效页码渲染，pagination 补充 defaultPage / defaultPageSize 初值；展开按钮补齐 type="button" 与展开态无障碍属性
  • 新增 输入框 Input / 搜索框 InputSearch / 文本域 Textarea / 数字输入框 InputNumber 的 blur 事件，参数为原生 FocusEvent
  • 优化 选择器 Select / 输入框 Input / 分页 Pagination 的尺寸切换过渡效果
  • 优化 表格 Table 的 sortChange 事件类型定义
  • 修复 对话框 Dialog / 模态框 Modal 的头部按钮缺少按压态与焦点环
  • 更新使用者文档与贡献者文档
  • 组件库脚本及配置优化
  • 组件库及文档代码优化

3.7.2
2026-11-03
​

  • 新增 间距 Space 的 split 插槽：在相邻内容之间插入分隔符，内容不足两个时不渲染
  • 新增 弹性布局 Flex 的 flex（容器自身作为 flex 子项时的伸缩简写，如 flex: 1）与 component（渲染的标签名或组件）属性
  • 修复 弹性布局 Flex / 间距 Space 的外部间距与空内容占位：写在组件上的 margin 类可正常生效，无内容（v-if 全不成立）时不再占位
  • 组件库及文档代码优化

3.7.1
2026-11-03
​

  • 拖拽上传改为遵循 上传 Upload 的 accept / multiple 约束：类型不符的文件不再入库，经新增的 reject 事件回传；关闭多选时拖入多个只取第一个文件
  • 修复 上传 Upload 的 maxCount：为 1 时占满后仍可上传替换当前文件，超出上限的文件不再写入列表
  • 修复 评分 Rate 的 change 派发时序：改在 v-model 更新后触发，@change 中不再读到旧值
  • 更新使用者文档与贡献者文档
  • 组件库及文档代码优化

3.7.0
2026-11-02
​

  • 可写字段改为「传值即受控」：value / open / activeKey 等传入后，交互只上报 update:、界面以父侧回写为准；只传值不监听 update: 的写法不再响应交互（评分 Rate、日期选择器 DatePicker、分页 Pagination 等），补 v-model 即可，原本就用 v-model 的无需改动
  • 修复 下拉菜单 Dropdown 受控时点击菜单项不收起：该次收起只上报 update:open，不触发 openChange
  • 修复 日历 Calendar 的 CalendarProps 缺少 value：显式标注该类型时 v-model:value 类型报错
  • 新增非受控入口：滑动输入条 Slider 的 defaultValue、标签页 Tabs / 折叠面板 Collapse 的 defaultActiveKey、分页 Pagination 的 defaultPage / defaultPageSize：不绑 v-model 时也能指定初值并正常交互
  • 新增 选择器 Select / 自动完成 AutoComplete 的 update:open 事件：面板开合支持 v-model:open；原有的 openChange / dropdownVisibleChange 继续派发
  • 新增各组件的 XxxSlots 类型导出（含 XxxProvider）：配合 defineSlots 可在二次封装时继承插槽名与作用域参数类型、插槽名写错在编译期报错；同时补齐 级联选择 Cascader 的 CascaderSearchSegment、选择器 Select 的 SelectMenuNode / SelectDropdownRenderParams / SelectTagRenderParams
  • 更新使用者文档和贡献者文档
  • 组件库及文档代码优化

3.6.0
2026-10-31
​

  • 重构 级联选择 Cascader：由三个并排选择框改为单选择器 + 多列浮层面板，层级不再固定三级；移除 gap / height / maxDisplay / search / filter（maxDisplay → panelHeight、search → showSearch、filter → showSearch.filter 且第二参改为完整路径），width / disabled / placeholder 不再接受数组，width 默认 auto → 184、allowClear 默认 false → true、placement 改四向取值（旧 'bottom' / 'top' 失效）、change 第二参改为选项数组
  • 新增 级联选择 Cascader 的多选（multiple / showCheckedStrategy / maxTagCount / maxTagPlaceholder / tagRender / getCheckedData）、showSearch 定制（filter / sort / limit / render / matchInputWidth）、loadData 异步加载、virtual 虚拟滚动、v-model:open / v-model:searchValue 受控、displayRender / expandTrigger / status / bordered、default / action 插槽、键盘操作（方向键跨列、Space 勾选、Backspace 删 tag）、theme.components.Cascader.primaryColor 组件级主色；使用者文档同步补全属性 / 事件 / 插槽说明
  • 组件库部分依赖版本升级
  • 组件库及文档代码优化

3.5.0
2026-10-30
​

3.4.2
2026-10-29
​

  • 重构 选择器 Select / 自动完成 AutoComplete 的下拉面板：外层包裹节点 .select-panel-wrapper / .auto-complete-panel-wrapper 移除，改由公共浮层容器承载（面板根 select-panel-container / auto-complete-panel 不变），依赖旧包裹节点的 :deep() 选择器改用 popupClassName / dropdownMenuStyle 或直接写面板根类名
  • 修复 下拉菜单 Dropdown、菜单 Menu 等浮层面板内嵌的 Tooltip / Popover 在面板关闭时不随之收起的问题
  • 组件库及文档代码优化

3.4.1
2026-10-28
​

  • 修复 全局化配置 ConfigProvider 的 baseZIndex 与 theme 在路由守卫中创建离散实例（createDiscreteApi）时不生效的问题
  • 贡献者文档补充 provide / inject 注入契约与守护说明
  • 组件库代码优化

3.4.0
2026-10-28
​

  • 移除 水印 Watermark 的 fixed 属性：fullscreen 水印始终固定于视口，原随文档滚动的写法改用非全屏水印包裹根内容；textStyle 的 fontWeight 'light' / 'weight' 改为 'lighter' / 'bolder'、fontStyle 的 'none' 改为 'normal'；offset 默认值改为 gap / 2（原 [50, 50]）
  • 新增 水印 Watermark 的 imageOpacity 与 textStyle 的 lineHeight / textAlign / fontVariant；图片水印未指定宽高时按原图比例显示，不再拉伸变形
  • 修复 水印 Watermark 的取色与绘制：直接写 <html data-va-mode> 切暗色时默认文字色跟随重绘，图片加载失败会提示缺少 CORS 响应头
  • 更新 水印 Watermark 的使用者文档与贡献者文档
  • 组件库及文档代码优化

3.3.2
2026-10-27
​

3.3.1
2026-10-26
​

  • 修复 文本滚动 TextScroll 的滚动启停、节奏与样式：start() 重复调用不再叠加滚动，KeepAlive 失活即暂停、返回后接着滚动，interval 改为纯停留时长（过渡另计 duration，同参数下整体变慢），ellipsis 下 itemStyle 的 maxWidth 生效
  • 更新组件库文档与贡献者文档

3.3.0
2026-10-25
​

  • 二维码 QRCode 中央图标底色属性 iconBackgroundColor 移除，改用 iconBgColor
  • 新增 二维码 QRCode 的 spinProps 属性，可配置 loading 状态的指示符与文案；遮罩不透明度改由 --qr-code-mask-opacity 控制，默认值由 1 改为 0.96
  • 优化 二维码 QRCode 的默认取色：color / bgColor / borderColor 改由主题变量驱动，暗色主题下二维码自动反色
  • 新增 菜单 Menu 深色皮肤（theme="dark"）的底色跟随主题色：根列表、浮层面板与内联子菜单同步换色相（theme.components.Menu.primaryColor 同样驱动）；新增 --va-bg-brand-dark-color / --va-bg-brand-dark-deep-color，浮层面板与内联子菜单可分别用 --va-menu-popup-background / --va-menu-inline-submenu-background 单独覆盖
  • 优化 加载中 Spin 翻转双环的配色（内环不再固定为主色），并消除两环交界处的叠压亮线
  • 优化 下拉菜单 Dropdown 与 选择器 Select 选项透传字段的类型，读取自定义字段无需再断言
  • 修复暗色主题下的对比度：抽屉 Drawer 面板阴影不再与遮罩叠出色带、轮播图 Swiper 分页器未选中的圆点与进度条轨道可见、徽标 Badge 实色底计数文字对比充足、日期选择器 DatePicker 与 时间选择器 TimePicker 范围箭头与面板协调
  • 更新使用者文档和贡献者文档
  • 组件库及文档代码优化

3.2.1
2026-10-24
​

3.2.0
2026-10-24
​

  • 重构并增强 文本省略 Ellipsis：提示显隐与溢出状态不再改变文本容器的结构、类名与样式，提示实例按需创建（受控开合时提前创建）；tooltip 由 boolean 扩展为 boolean | EllipsisTooltipProps，原先直接写在组件上的 文字提示 Tooltip 属性（如 bg-color / trigger）需移入该对象，content-class / content-style 一并失效（类名与样式直接写在组件上），并新增 EllipsisTooltipProps 类型导出；expand 在单行文本下同样可展开
  • 优化 浮动按钮 FloatButton：无提示内容时不再创建 文字提示 Tooltip 实例，按钮的结构、类名与尺寸保持不变
  • 新增 文字提示 Tooltip 的 anchor 与 getDisabled 属性：前者传入外部元素作为锚点（不再渲染触发包裹层），后者在每次展示前判定是否允许展示
  • 更新组件库文档

3.1.0
2026-10-23
​

  • 时间轴 Timeline 的属性与插槽调整：移除 items 属性与 Item 类型（节点改用 TimelineItem 承载）、width（宽度交由宿主布局控制）与空内容 -- 占位；desc → content、lineStyle → lineType、mode 的 center → alternate、容器 position → start（默认 left → right，交替模式内容先从右侧出现）；旧 dot / desc 作用域插槽改为无作用域参数的 dot / 默认插槽
  • 时间轴 Timeline 的类名与类型更名：除 timeline-wrap 外类名一律更名（如 timeline-item → timeline-item-wrap、timeline-dot → timeline-item-head），依赖旧类名的自定义样式需同步改写；TimelineItem 类型改为同名组件、节点配置类型改用 TimelineItemProps
  • 时间轴 Timeline 拆分为容器 + TimelineItem 节点组件（容器只管整体布局与状态，数据场景直接 v-for 渲染），新增幽灵节点 pending / pendingDot（内置加载环）、倒序 reverse、水平排列 horizontal（超出可横向滚动）与尺寸档位 size / iconSize
  • TimelineItem 补齐 title / content / time 三段结构与左侧标签 label，支持 position / lineType 单侧覆盖、自定义轴点插槽与预设语义色轴点
  • 优化 时间轴 Timeline 的节点结构语义：改为 ul / li 语义化列表，补齐无障碍语义与系统「减少动效」偏好下的表现
  • 组件库文档更新优化

3.0.0
2026-10-22
​

  • 全局化配置 ConfigProvider 的 theme 改为 { seed, mode, components }：原 { common, 组件名 } 写法移除（组件级配色改用 theme.components），颜色只需给种子，色阶、状态色与暗色档位由库内派生；主题相关迁移（theme 形状、abstract 默认值、被移除的工具函数与私有变量）对照见定制主题
  • 全局化配置 ConfigProvider 的 abstract 属性默认值由 true 改为 false：实例默认渲染一层包裹元素（tag 可换 span 等），主题只作用于自身子树；需要页面级主题（Teleport 浮层、页面链接色）时在最外层显式传 :abstract="true"
  • 旧版由 JS 注入的 --<组件名>-primary-color 一类主题变量移除：曾用它们覆盖组件配色的样式需改为 --va-<组件名>-* 令牌或 theme.components
  • 移除 toggleDark / rafTimeout / cancelRaf / getColorPalettes / getAlphaColor 与 AnimationFrameID 类型：暗色切换改用 theme.mode 或直接写 data-va-mode，延时改用 setTimeout / 原生 requestAnimationFrame，取色改用 derive(seed, mode)
  • 水印 Watermark 的默认色改为语义变量：显式传 textStyle.color 后不再随明暗模式反转
  • 重建主题变量契约：新增主色阶 / 状态色 / 文字 / 底色 / 边框 / 填充 / 投影 / 遮罩等全局语义变量与组件令牌（含 滑动输入条 Slider 刻度点描边），组件配色统一只取 --va-*（含 --va-cp-* 组件主色桥），在任一祖先选择器上即可整组换肤或逐值改单点
  • 全局化配置 ConfigProvider 新增暗色模式 theme.mode（light / dark / auto，auto 跟随系统配色）：纯 CSS 场景直接写 <html data-va-mode="dark"> 即可，Teleport 浮层与页面链接一并跟随
  • 暗色主题下补齐各浮层与固定色表面：模态框 Modal、抽屉 Drawer、图片 Image 预览、对话框 Dialog、二维码 QRCode、菜单 Menu 折叠气泡、颜色选择器 ColorPicker、标签 Tag、表格 Table、列表 List
  • 全局化配置 ConfigProvider 新增组件级主色 theme.components.<组件名>.primaryColor，覆盖所有使用主色的内置组件，键名写错会在编译期报错
  • 新增主题公开出口 derive / DEFAULT_PRIMARY / DEFAULT_SEEDS / THEME_VAR_NAMES / MODE_ATTRIBUTE 与 ThemeSeed / ThemeMode / ResolvedMode / ThemeVars / ThemeSnapshot / ComponentThemeConfig / ThemeComponentKey 类型，脚本取色与 --va-* 取同一份派生结果
  • 统一库内告警输出：error 全环境输出、warn / debug 仅开发期输出，同一提醒只输出一次；二维码 QRCode 编码 / 绘制失败与 折叠面板 Collapse 复制失败改为 error
  • 离散 API（createDiscreteApi）的浮层不再改写 <html>：未传主题时继承主应用主题，传 configProviderProps.theme 时在该浮层内独立生效（见离散 API 的主题），dispose() 也不会误清主应用写入的变量
  • 全量适配组件库浅色和暗色主题
  • 修复 水印 Watermark fixed=false 时只覆盖首屏的问题
  • 修复 日历 Calendar 年选择器选中年份后列表区间随面板平移、需重新展开才滚动到选中项的问题
  • 修复 按钮 Button 点击后动画未结束即被禁用、重新启用时凭空播放波纹的问题
  • 修复 进度条 Progress 进度值越界或非数导致进度条显示异常的问题
  • 修复 回到顶部 BackTop 提示气泡的圆角被库强制覆盖、无法沿用 文字提示 Tooltip 自身圆角的问题
  • 更新组件库文档和贡献者文档
  • 组件库及文档代码优化

2.15.2
2026-10-19
​

  • 移除 单选框 Radio 与 复选框 Checkbox 的 options / vertical / gap 属性，配置式写法改用 RadioGroup / CheckboxGroup；Checkbox 的 value 不再接受数组；Radio 的 buttonSize 更名为 size（在组内由组的 size 下发）；选项类型统一为 RadioGroupOption / CheckboxGroupOption（RadioOption / CheckboxOption 不再导出）
  • 单选框 Radio 与 复选框 Checkbox 新增 RadioGroup / CheckboxGroup 组合式用法：统一下发选中值与禁用态并承载组内选项，组内项以 value 标识自身（Radio 另有 RadioButton 按钮形态），options 支持字符串 / 数字简写与 VNode 选项名
  • 单选框 Radio 与 复选框 Checkbox 改为原生 input 承载：name 下发到组内每个 input，id（前缀 + 选项下标）与 autofocus 在 options 模式下下发，补齐键盘操作与屏幕阅读器语义，暴露 focus() / blur() 实例方法；change 事件在首参「新值」之后追加事件对象（状态快照与原始事件），首参用法不变；新增 RadioChangeEvent / CheckboxChangeEvent 类型导出
  • 修复 单选框 Radio 与 复选框 Checkbox 定高行内与输入框混排时文字与控件基线错位、内容溢出行盒的问题，并优化选中反馈
  • 日历 Calendar 的模式切换器改用 RadioGroup，modeRadioProps 类型同步改为 RadioGroupProps
  • 修复 输入框 Input 未绑定 v-model 时输入内容（含输入法合成文本）因悬浮 / 聚焦等状态变化丢失，以及与文字混排时压低行内文字基线的问题
  • 更新使用者文档与贡献者文档
  • 组件库及文档代码优化

2.15.1
2026-10-18
​

  • 日历 Calendar 的 select 改为每次选中都触发（含重复点击已选中日期），第二参改为 { source }（新增 year / customize 来源）；年 / 月选择器与键盘操作同样写回选中值并触发 change / select，panelChange 在跨月 / 跨年时补发；移除 dateStrip 属性（日期区恒定渲染六周），新增 CalendarSelectInfo 类型导出
  • 日历 Calendar 新增 defaultValue / validRange（字符串按 valueFormat 解析，区间外的年 / 月选项一并收窄）与 headerFull / dateFull / monthFull 插槽，mode 改为受控（外部变更同步到面板），并补齐键盘导航（月份面板按月步进）、grid 无障碍语义、整月 / 整年禁用与窄屏头部
  • 修复 日历 Calendar 的取值与显示
  • 更新使用者文档：日历 Calendar 演示补充；文档站补充社交分享卡片的标签与封面图
  • 组件库及文档代码优化

2.15.0
2026-10-17
​

  • 颜色选择器 ColorPicker 的浮层改为组件自持，显隐改用 v-model:open（原 v-model:show），面板样式改用 panelStyle / panelClass（原 tooltipStyle）；原 文字提示 Tooltip 派生属性（延迟、箭头等）与 trigger 插槽旧回传值移除（现回传 { value }，程序化开合请用 v-model:open）；complete 事件改为仅在输入框提交或拖动结束时触发（依赖「选色即完成」请改用 update:value）
  • 文字提示 Tooltip（含派生的 气泡卡片 Popover / 气泡确认框 Popconfirm）的显隐双向绑定统一为 v-model:open（原 v-model:show），showControl 改名为 openControl
  • 颜色选择器 ColorPicker 新增 defaultOpen / openChange / destroyOnHide / placement / to / zIndex / offset 属性，并修复非法色值与越界输入导致崩溃、禁用态仍可展开、panelStyle 宽度反复展开跳变
  • 修正 上传 Upload 的告警：beforeUpload 返回 false 时不再误报「执行出错」，回调异常改走 error 级；开发期告警统一为 [vue-amazing-ui] {组件名}: {说明} 前缀（此前在库构建下从不输出）
  • 更新使用者文档与贡献者文档
  • 组件库及文档代码优化

2.14.2
2026-10-16
​

  • 回到顶部 BackTop 的 listenTo 支持按 CSS 选择器解析字符串参数（元素标签名本身是合法选择器，原写法仍有效）
  • 新增 滚动条 Scrollbar 实例属性 scrollElement，可获取内部滚动容器元素
  • 菜单 Menu 的 select / deselect 事件参数类型由 SelectInfo 调整为 MenuSelectInfo
  • 更新使用者文档：布局 Layout 补充 CSS 变量清单与浅色侧边栏覆盖示例，栅格 Grid 补充固定高度容器下 align="stretch" 的生效边界，回到顶部 BackTop 补充容器内滚动的监听目标选取；同步修正 getScrollData 类型签名（补全 scrollTop）
  • 组件库及文档代码优化

2.14.1
2026-10-15
​

  • 二维码 QRCode 的 errorLevel 改为「最低等级」且默认值由 'H' 改为 'M'（需保留原行为可显式设置 errorLevel="H"）、scale 改为「最小像素倍率下限」，实例方法 getQRCodeImage 更名为 toDataURL 并改为同步返回 string（await ref.getQRCodeImage() 改为 ref.toDataURL()）
  • 二维码 QRCode 与 回到顶部 BackTop 的根类名与 CSS 变量前缀统一为组件目录名的短横线形式（qrcode-wrap → qr-code-wrap、--qrcode-* → --qr-code-*，BackTop 的 desc → description），依赖旧类名 / 变量的自定义用法需同步调整
  • 二维码 QRCode 编码改为内置实现（移除第三方依赖，体积减小），canvas / image 高清屏清晰度提升，并修复 canvas 不渲染、重复更新累积画布、中央图标缺底色块 / 被拉伸、bordered 绘制区尺寸偏差与跳动
  • 二维码 QRCode 新增 status 属性与 refresh 事件（active / expired / loading / scanned 四种状态，含遮罩与点击刷新）、iconBackgroundColor / iconBorderRadius / title / padding 属性与 --qr-code-mask-bg-color / --qr-code-mask-text-color 遮罩变量，中央图标绘入二维码本体（导出图片同样包含）
  • 更新使用者文档：二维码 QRCode 的演示补充

2.14.0
2026-10-14
​

  • 新增 时间选择器 TimePicker 组件：时分秒三列滚动面板，支持 type="timerange" 范围形态、12 小时制与步长配置；全局化配置 ConfigProvider 的 theme 同步新增 TimePicker 键
  • 重构 日期选择器 DatePicker 为自研实现（移除第三方依赖）：v-model 改用 v-model:value / v-model:formatted-value（毫秒时间戳 / 字符串双轨），modelType 改用 valueFormat，mode / range / showTime / maxRange 移除（形态改由 type 承担），format 不再支持函数形态，showToday 默认值由 false 改为 true
  • 增强 日期选择器 DatePicker：新增日期时间、周、月 / 季 / 年及各自的范围形态（含 presets 预设范围与按段配置），以及面板定制（dateRender / renderExtraFooter）、键盘导航与无障碍语义，并新增 defaultTime / allowEmpty / showNow / showArrow / inputReadOnly / panelClass / panelStyle / zIndex 等属性与 panelChange 事件
  • 修复锁定页面滚动时背景页面与浮层横向抖动、且页面仍可横向推移的问题：锁定期间横向滚动一并禁用，被回收的滚动条宽度等量补偿，库内常驻的 回到顶部 BackTop 与 浮动按钮 FloatButton 一并补偿（宿主自有固定定位元素可用 --va-scrollbar-width 自行补偿）
  • 组件库不再对外导出 lockScroll 工具函数
  • 全局字体口径调整：库不再声明字体族，组件与内容继承宿主字体（原生表单控件由 font-family: inherit 兜底），浮层改为承接触发位置的字体族
  • 组件库所有组件内部样式变量统一加组件名前缀，如曾用它做过外部覆盖，请同步改名
  • 更新使用者文档与贡献者文档
  • 组件库及文档代码优化

2.13.2
2026-10-13
​

2.13.1
2026-10-12
​

  • 优化并增强 加载中 Spin：新增 delay / fitContent 属性与自定义指示符（indicator 属性 / #indicator 插槽，含 SpinIndicator / SpinBuiltinIndicator 类型导出）；重做点阵 / 线阵与 magic-ring 翻面动效，speed / spinCircleWidth 现同时支持 magic-ring；指示符进出淡入淡出；修复 spinCircleWidth / spinCirclePercent 越界值导致指示符消失
  • 重命名 加载中 Spin 属性 indicator 取值：spin-dot → dot-wheel、spin-line → line-wheel（旧值已移除）

2.13.0
2026-09-30
​

  • 新增 布局 Layout 组件：含 Layout / LayoutHeader / LayoutContent / LayoutFooter / LayoutSider，支持侧边栏收起与 light / dark 主题
  • 新增 导航菜单 Menu 组件：支持 items 配置与 MenuItem / MenuSubMenu / MenuItemGroup / MenuDivider 子组件两种写法，含 horizontal / vertical / inline 三种菜单类型与 light / dark 主题，展开与选中可受控、可多选，inline 支持收起与缩进，水平溢出收进省略子菜单
  • 增强 全局化配置 ConfigProvider：theme 新增 Menu 键（可按 Menu 覆盖主题色）；common.primaryColor 派生的色阶写入 --va-link-color / --va-link-color-hover / --va-link-color-active，页面链接颜色随主题色一并变化 —— 默认写到 :root 全局生效，:abstract="false" 的嵌套实例只在自身子树内生效
  • 优化 全局提示 Message 的进出场动效时长
  • 修复 滑动输入条 Slider 手柄气泡在贴近容器边缘时不再居中的问题
  • 全局默认样式的 <a> 重构为 :where() 包裹的低特异性链接基座，配色改由主色色阶决定（常态 / 悬停 / 按下为 #1677ff / #69b1ff / #0958d9，原悬停色 #4096ff），且不再移除焦点轮廓；同时移除 --primary-color / --primary-color-hover 主题变量，主题色请改用 全局化配置 ConfigProvider 的 theme
  • 更新 全局化配置 ConfigProvider 文档：新增「链接颜色跟随主题」章节（变量、作用域与自定义覆盖写法），主题示例与 ComponentName 类型补 Menu，并订正 tag 属性的生效条件为 abstract 为 false 时有效
  • 更新贡献者文档：development/ 的全局样式说明改为「组件样式基座 + 主题色由 ConfigProvider 提供」，并补充链接色变量的双作用域写入规则
  • 组件库及文档优化

2.12.0
2026-09-24
​

2.11.0
2026-09-23
​

  • 优化统一 选择器 Select、级联选择 Cascader、开关 Switch 的 API 形态：双向绑定改用 v-model:value（回写事件 update:value）；label / value 字段名属性合并为 fieldNames 对象，改用 :field-names="{ label: 'name', value: 'id' }"（分组 / 后代子选项字段名分别为 Select 的 options 与 Cascader 的 children``）；Select 的 search / filter 更名为 showSearch / filterOption（旧名移除）、placement 取值扩展为四向（默认 bottomLeft）、change 回调第二参由文本 label 改为完整 option 对象，并新增 SelectValue / SelectFieldNames / CascaderFieldNames 类型导出
  • 重构并增强 选择器 Select：单选模式属性 / 事件 / 插槽 / 方法全量补齐（bordered / status / loading / dropdownRender / notFoundContent 等属性与 focus() / blur() / scrollTo() 等方法），新增多选 / 标签模式（mode、标签折叠 maxTagCount / tagRender、tokenSeparators 分词与 deselect 事件，多选下 value 为数组）、labelInValue、子组件式选项 SelectOption / SelectOptGroup、默认开启的虚拟滚动 virtual 与无障碍语义，并优化下拉面板滚动越界回弹；按选项文本搜索需显式传 option-filter-prop="label"
  • 描述列表 Descriptions 与 列表 List 的主组件上提至组件目录顶层；自动按需引入不受影响，手动引入样式需将 descriptions/descriptions/style 改为 descriptions/style，list 同理
  • 修复聚合入口具名导出在产物 JS 中缺失的问题：Row / Col / useDialog / useMessage / useModal / useNotification / useLoadingBar / createDiscreteApi 此前从包入口具名引入时运行时为 undefined，现均可正常引入
  • 补齐 轮播图 Carousel 的插槽类型声明（新增 CarouselSlots 类型），自定义箭头 / 圆点插槽可获得作用域参数类型提示
  • 组件库及文档代码优化

2.10.1
2026-09-22
​

  • 重构 加载条 LoadingBar 为 Provider + Hook 形态：新增 <LoadingBarProvider> + useLoadingBar() 与 createDiscreteApi(['loadingBar']) 两种 api 获取方式（形态与 全局提示 Message / 模态框 Modal 等同族组件一致），并新增 loadingBarStyle 属性（可按 loading / finish / error 三态注入自定义样式）；<LoadingBar> 组件本体继续导出，props 与 start / finish / error 方法签名不变，但 api 由 ref 改为经 @ready 回传 —— 原 <LoadingBar ref="loadingBar"> + loadingBar.value.start() 写法需迁移为 <LoadingBar @ready="api = $event" /> 或改用 useLoadingBar()
  • 修复 createDiscreteApi 在路由守卫（app.runWithContext 上下文）中调用时取不到 api 的问题，影响 加载条 LoadingBar / 对话框 Dialog / 全局提示 Message / 模态框 Modal / 通知提醒 Notification
  • 更新使用者文档：加载条 LoadingBar 重写演示与 api 用法说明（改用 <LoadingBarProvider>），全局化配置 ConfigProvider 与 快速上手 的加载条示例同步迁移
  • 更新贡献者文档：development/component-design.md 将 loading-bar 纳入「SFC + Hook + Provider」三段式清单并补充 LoadingBarProvider 的样式入口登记，development/demo-doc-guide.md 的全局包裹写法同步改为 useLoadingBar()

2.10.0
2026-09-21
​

  • 新增 评论 Comment 组件
  • 重构按需引入的样式注入为「每组件一个样式入口」：手动引入可用 import 'vue-amazing-ui/es/button/style' 一次引全全局默认样式、组件自身样式与其依赖组件样式，无需再自行列举；自动按需引入（VueAmazingUIResolver）用法与行为不变
  • 更新使用者文档：按需引入、快速上手 与 特性 的手动引入示例统一改用上述样式入口写法并合并重复内容，README 同步；组件文档示例风格与文档站正文样式一并订正
  • 更新贡献者文档：development/ 补充样式入口模型、构建后处理与产物校验说明，并同步「新增组件三步接线」清单；CONTRIBUTING 补充 pnpm verify 门禁与对应自检提示
  • 工程优化：新增 GitHub Actions 门禁、按需引入的产物级校验脚本与发布守卫等

2.9.0
2026-09-20
​

2.8.1
2026-09-15
​

  • 新增 滑动输入条 Slider 的 SliderMarks 类型导出，用于标注刻度数据的类型
  • 优化并统一 图片 Image / 轮播图 Swiper / 瀑布流 Waterfall 的图片名称提取：统一从 src 解析末段，剥离查询参数与哈希并做 URL 解码，alt 与下载文件名更准确
  • 修复 消息提示 Message / 通知提醒 Notification 的 icon 传入字符串时不显示内容的问题，现统一渲染为文本节点
  • 重构组件库内部公共能力（内容渲染、实例标识生成、焦点锁定、水波纹状态、视口宽度响应等），抽取为公共工具函数与组合式函数
  • 收敛 createDiscreteApi 的内部类型导出：DiscreteApiType / MaybeRef / DiscreteApi 不再对外导出，仅影响从深层子路径导入的写法；DiscreteApiOptions / DiscreteApiInstance 不受影响
  • 优化发布脚本：发版时输出可点击的 git tag 链接
  • 更新使用者文档：轮播图 mousewheel 演示默认开启、数字动画补全精度示例、主题定制与刻度示例改用 import type 导入类型
  • 更新使用者文档：类型引用统一为公开导出名（如 TabsItem / SwiperImage / UploadFileType），使用时可直接 import type 使用
  • 组件库文档优化

2.8.0
2026-09-14
​

  • 重构并增强 描述列表 Descriptions：改为数据驱动渲染，新增 layout / colon / labelAlign 等属性、#header 插槽与 xxxl 断点，修复子项丢失等问题。移除 vertical 属性，改用 layout="vertical"
  • 增强 抽屉 Drawer：新增 to / push / size / mask 等属性、afterOpenChange 事件与 #closeIcon 插槽，支持多层推动与 class / style 透传，修复打开后页面滚动被永久锁死。默认挂载到 body，依赖原渲染位置的样式需改用 to 或 rootClassName 定制
  • 修复 对话框 Modal / Dialog / 加载条 LoadingBar / 消息提示 Message / 通知提醒 Notification 的 class / style 无法透传问题
  • 增强 轮播图 Carousel：新增 loop / initialIndex / 受控 currentIndex 等属性、beforeChange / afterChange 事件与 #prevArrow / #nextArrow / #dots 插槽，修复越界、加载失败、动画中断等交互问题；fadeFunction 默认值由 'cubic-bezier(0.4, 0, 0.2, 1)' 改为 [0.4, 0, 0.2, 1]。属性 dotsTrigger 更名为 dotTrigger；移除 change 事件，切换监听改用 beforeChange / afterChange，当前页同步使用 v-model:current-index
  • 增强 数字动画 NumberAnimation：缓动支持传入三次贝塞尔控制点数组与缓动函数，卸载时中止在飞动画。属性 transition 更名为 easing，类型 NumberAnimationTransitionFunc 更名为 NumberAnimationEasingPreset
  • 优化工具函数文档：补充边界说明与可运行示例
  • 修复 lockScroll 在 SSR / Node 环境调用报错；订正 useOptionsSupported 参数名为 option
  • 修复按需引入 VueAmazingUIResolver 引用 DescriptionsItem 不存在的样式路径

2.7.4
2026-09-12
​

  • 优化 useSlotsExist 作用域插槽在探测时因无参调用触发形参位置解构的 TypeError，导致整页渲染中断，同时新增单元测试
  • 增强 徽标 Badge：数值变化时数字逐位上下滚动（超出 max 展示 max+），离场期间保留隐藏前最后展示的数值；showZero 动态切换时同步刷新展示值
  • 优化 警告提示 Alert：重构关闭离场动画，冻结高度后平滑收缩、同步收起内边距与下边距、动画结束才卸载元素；新增 afterClose 事件
  • 新增 统计数值 Statistic tabularNums 属性：数值滚动时使用等宽数字，避免宽度抖动
  • 优化 选择器 Select：面板打开时自动将当前选中项滚动到可视区域内
  • 修复 formatNumber：数值为 0 时丢失 prefix / suffix 的问题
  • 优化多个组件全局文字断行：word-break: break-all 调整为 break-word，避免英文单词与数字被从中间截断
  • 组件库文档及工程优化

2.7.3
2026-09-11
​

2.7.2
2026-09-10
​

  • 修复 SSR / Node 渲染报错：Avatar、Row / Col、Descriptions、QRCode、Tag、Watermark 及 useMediaQuery、useFps、useMutationObserver、useResizeObserver、useScrollParent
  • 修复卸载后定时器 / 动画帧泄漏：Countdown、Carousel、TextScroll、Select、useFps、useMediaQuery
  • 修复 Carousel 容器尺寸为 0 时自动轮播失效、Select 搜索过滤自触发循环、Tag 动态编辑后输入框未清空、Upload 重复选择同一文件不触发 change、QRCode canvas 未就绪时跳过绘制、cancelRaf 帧 id 为 0 时误判
  • 澄清 rafTimeout 语义：回调绑定渲染帧、页面不可见时暂停，与 setTimeout / setInterval 不等价
  • 优化 Rate 未选中状态守卫；收敛组件与演示的模板引用类型，并为可空引用补充 ?. 与判空守卫
  • 工程优化：postcss + autoprefixer 按 browserslist 补齐产物 CSS 厂商前缀，vue 提升为 peerDependencies，engines / packageManager 收紧；新增 prepublishOnly 产物入口守卫与 format:check 门禁

2.7.1
2026-09-09
​

  • 优化 Dialog / Modal 的点击展开：修复命令式场景（如 createDiscreteApi）点击丢失、退回中心；离场动画按打开时的位置收起
  • Avatar、BackTop、Button、FloatButton、Popconfirm 的 icon 类型由 VNode | Slot 收紧为 VNode | (() => VNode)，不再支持直接传组件对象，改用 h(...) 渲染函数或 #icon 插槽
  • 类型强化：具名 / 作用域插槽组件补充 xxxSlots 类型并接入 defineSlots()，文档类型表同步清理 string | slot 写法

2.7.0
2026-09-08
​

  • 移除 Message、Notification、Modal 实例 ref 上的命令式方法，统一改用 useXxx()（需外层 XxxProvider）或 createDiscreteApi()；Dialog 新增 useDialog() / createDiscreteApi() 命令式入口；window['$xxx'] 写法改为赋值 api；@ready 回传 api，句柄支持 destroy() / update()，Notification 额外支持 destroy(key) 按 key 精确关闭
  • 调整四组件浮层默认挂载：Teleport 到 body，新增 to 指定挂载节点；依赖原渲染位置的 scoped 样式与 :deep() 覆写失效，需改为全局样式
  • 调整 Notification：description 更名 content、移除组件级 title / description、top / bottom 默认 24 → 16；Message 单条配置移除 top
  • 调整 Modal 命令式 maskClosable 默认改 false（组件级仍为 true）、Esc 监听改绑弹窗主体（焦点移出弹窗后不再响应）、入口类型导出由 Props / Modal 调整为 ModalProps / ModalOptions / ModalUpdate / ModalReactive / ModalApi；Upload 移除内嵌 Message：messageProps / actionMessage / UploadMessageType 及相关方法移除，改用 success / error / remove 事件
  • 重构并增强 Dialog / Modal：改为多实例层叠架构，新增 mask / closable / closeIcon、wrapClass / containerClass 等分层定制与 onEsc / onMaskClick / afterClose 回调（其中 Dialog 额外新增 draggable 拖拽），title / content 支持 string / VNode / 渲染函数 / 插槽，并补充 aria-* 与可聚焦关闭按钮
  • 增强 Notification / Message：新增 maxCount / keepAliveOnHover / to 等属性，Notification 新增 key 与 placement 的 top / bottom 居中位置；定时器改为按 key 独立管理，修复多条干扰与常驻消息阻塞回收
  • 新增 lockScroll 工具函数（第 24 个），Drawer / Modal / Dialog 统一改用并补充卸载兜底释放；修复 Table 就地改写用户 columns、空 columns 崩溃与 colspan 计算错误
  • 优化 VueAmazingUIResolver 按需引入：新增四个命令式 Provider 组件的自动引入与样式注入，修复 Modal / Notification 缺失 Scrollbar 样式依赖
  • 工程优化：xxxProps 类型由 object 精确为对应 Props；新增 vitest 单元测试并纳入 pnpm check；新增 development/ 设计指南

2.6.2
2026-08-30
​

  • 优化 下载文件 downloadFile 工具函数和文档：iframe 策略在未传入文件名时，自动从文件地址中提取文件名并拼接 response-content-disposition 参数，与 anchor 策略行为对齐，修复跨域图片 / PDF 等可预览类型在 iframe 内预览而非下载的问题；地址无有效文件名时（如纯域名）不拼接参数，避免发出 filename 为空的畸形请求
  • 优化 图片 Image：未显式设置 name 时，自动使用从图片地址中提取的图片名称，内置下载与 customDownload 自定义下载方法均生效
  • 优化组件库发布脚本
  • 组件库配置及文档代码优化

2.6.1
2026-08-29
​

  • 优化并重构 通知提醒 Notification，修复不同弹出位置的通知相互干扰的问题，多个弹出位置的通知可同时独立展示；自动关闭时长改为优先取单条通知的 duration，未设置时使用组件默认 duration
  • 优化 图片 Image：支持从图片地址提取图片名称，兼容相对路径与带查询参数 / 哈希的地址，并支持 URL 解码（含非法百分号编码兜底）；优化预览动画效果，遮罩层与预览图动画一致
  • 优化组件库发布脚本
  • 组件库及文档代码优化

2.6.0
2026-08-28
​

  • 更新使用者文档：文档路径统一为短横线命名，侧边栏与引用链接同步
  • 拆分 utils 为多模块并整理导出；新增抽象弹出定位与滚动感知组合式函数，重构 选择器 Select、文字提示 Tooltip、自动完成 AutoComplete 等弹出类组件代码
  • 优化 全局化配置 ConfigProvider 的组件实现
  • 优化 自动完成 AutoComplete 文档及演示用例
  • 优化按需引入时第三方样式的处理
  • 优化并重构 下载文件 downloadFile 工具函数：内置同源 anchor 与跨域 iframe 双下载策略并自动分流，支持自定义文件名（含中文）与下载策略配置
  • 优化 图片 Image 和文档用例，新增 downloadOptions、customDownload 属性，支持调整内置下载策略或提供完全自定义的下载方法
  • 优化组件库 vite 构建配置逻辑与按需引入 resolver 逻辑
  • 修复全局样式导入 import 'vue-amazing-ui/css' 的 TypeScript 类型声明缺失问题
  • 优化组件库发布脚本，发版时自动生成并推送版本标签，并自动创建与标签同名的 GitHub Release
  • 组件库及文档代码优化

2.5.3
2026-08-26
​

  • 优化 自动完成 AutoComplete 和文档：新增 width 属性，支持显式指定组件宽度
  • 优化 全局化配置 ConfigProvider 和文档：Theme 类型新增 AutoComplete 组件级主题色配置，修复 AutoComplete 无法通过 theme.AutoComplete 单独定制主题色的问题
  • 组件库配置优化

2.5.2
2026-08-25
​

2.5.1
2026-08-24
​

  • 优化并增强 文字提示 Tooltip 和文档，placement 属性新增支持 12 个方向；新增 arrowPointAtCenter 属性使箭头指向目标元素中心；bgColor 支持多种预设色彩；trigger 新增 focus / contextmenu 触发方式；新增 disabled 属性支持禁用；showDelay / hideDelay 属性调整为仅在 trigger: hover 时生效，click / focus / contextmenu 等触发方式立即显示与隐藏；修复弹出框挂载到 body 时被中间可滚动容器边界误判导致意外翻转的问题
  • 优化 颜色选择器 ColorPicker 和文档，优化弹层定位与显隐行为：弹层定位由 bottom 调整为 bottomLeft，避免面板与触发元素错位；新增 keyboard 键盘支持；showDelay / hideDelay 调整为立即显示与隐藏
  • 优化 文本省略 Ellipsis，过渡动画时长与库默认档位对齐
  • 组件库及文档代码优化

2.5.0
2026-08-19
​

2.4.27
2026-08-17
​

  • 修复 搜索框 InputSearch 搜索按钮与输入框连接处的样式问题
  • 优化 走马灯 Carousel slideFunction 属性类型定义，由 string | number[] 精确为 CubicBezierPoints | EasingFunction，提供更准确的类型提示
  • 新增项目贡献指南，优化项目构建、工程配置及发布流程
  • 组件库及文档代码优化

2.4.26
2026-05-31
​

  • 优化 滚动条 Scrollbar 使用效果，调整属性 autoHide 默认值为 false，delay 属性默认值为 0

2.4.25
2026-05-30
​

2.4.24
2026-03-08
​

2.4.23
2025-11-17
​

2.4.22
2025-10-15
​

  • 优化 滚动条 Scrollbar 的组件实现，修复当使用 Methods 进行滚动时滚动条无法正常显示的问题
  • 优化 表格 Table 的组件实现
  • 优化 标签页 Tabs 的组件实现
  • 更新组件库部分依赖版本

2.4.21
2025-09-05
​

  • 优化 选择器 Select，兼容弹出框在文档中自动调整弹出位置的功能
  • 更新组件库部分依赖版本

2.4.20
2025-09-02
​

2.4.19
2025-08-28
​

  • 优化 选择器 Select，新增 placement flip to 属性，支持：设置下拉面板弹出位置；设置下拉面板被浏览器窗口或最近可滚动父元素遮挡时自动调整弹出位置；设置下拉面板挂载的容器节点，默认挂载到 body 下
  • 优化 文字滚动 TextScroll，属性 amount 新增 false 类型，用于支持所有文字平铺展示；新增 ellipsis ellipsisProps 属性，支持：设置文字超出时是否启用文本省略组件；配置文本省略组件属性
  • 组件库及文档代码优化
  • 更新组件库部分依赖版本

2.4.18
2025-08-22
​

2.4.17
2025-08-21
​

2.4.16
2025-08-19
​

2.4.15
2025-08-18
​

  • 优化 文字提示 Tooltip，新增 to 属性，支持设置弹出框挂载的容器节点，默认挂载到 body 下
  • 优化组件库部分使用 Tooltip 组件的代码逻辑
  • 更新组件库部分依赖版本

2.4.14
2025-06-19
​

2.4.13
2025-06-05
​

  • 优化 表格 Table，新增 rowKey 属性，用于支持设置表格内容行的唯一标识 key

2.4.12
2025-06-04
​

2.4.11
2025-06-02
​

2.4.10
2025-05-30
​

2.4.9
2025-05-29
​

2.4.8
2025-05-26
​

  • 优化 图片 Image，修复图片已加载（含缓存与 SSG 场景）时加载态不消失的问题；新增 previewSpinProps 配置预览加载中样式

2.4.7
2025-05-23
​

2.4.6
2025-05-22
​

  • 优化 文字提示 Tooltip，优化自动查找最近的可滚动父元素
  • 优化 输入框 Input，修复使用文本合成系统输入时的问题；新增 compositionstart compositionend 回调事件
  • 优化 搜索框 InputSearch，修复使用文本合成系统输入时的问题；新增 compositionstart compositionend 回调事件
  • 优化 文本域 Textarea，修复使用文本合成系统输入时的问题；新增 compositionstart compositionend 回调事件
  • 更新组件库文档及部分依赖版本

2.4.5
2025-05-06
​

2.4.4
2025-04-16
​

2.4.3
2025-03-27
​

  • 优化日期选择器 DatePicker，新增 maxRange 属性，用于支持自定义最长日期可选择范围
  • 组件库及文档代码优化

2.4.2
2025-03-25
​

  • 组件库及文档代码优化

2.4.1
2025-03-21
​

2.4.0
2025-03-19
​

2.3.4
2025-03-18
​

2.3.3
2025-03-17
​

  • 组件库及文档代码优化

2.3.2
2025-03-15
​

  • 优化 按钮 Button，删除 rippleColor 属性，新增 color 属性，支持自定义按钮颜色
  • 修复 进度条 Progress 渐变进度圈展示
  • 组件库及文档代码优化

2.3.1
2025-03-14
​

  • 优化 全局化配置 ConfigProvider，新增 abstract tag 属性，支持：设置是否不存在 DOM 包裹元素；自定义 ConfigProvider 被渲染成的元素，abstract 为 true 时有效
  • 更新自动按需引入，修复 全局化配置 ConfigProvider 引入的问题
  • 组件库及文档代码优化

2.3.0
2025-03-13
​

  • 新增 全局化配置 ConfigProvider，用于支持全局自定义主题色
  • 优化 加载条 LoadingBar 的组件实现
  • 优化支持自定义主题色的组件，用于配合 ConfigProvider 组件支持全局自定义主题色
  • 组件库及文档代码优化

2.2.15
2025-03-07
​

2.2.14
2025-03-06
​

2.2.13
2025-03-05
​

2.2.12
2025-03-04
​

2.2.11
2025-02-28
​

2.2.10
2025-02-27
​

2.2.9
2025-02-26
​

  • 优化 表格 Table 的类型定义
  • 滑动输入条 Slider 新增 marks 属性，支持刻度标记与自定义标记样式；step 类型扩展为 number | 'mark'，取 'mark' 时可选值仅为刻度取值
  • 组件库及文档代码优化

2.2.8
2025-02-22
​

2.2.7
2025-02-21
​

2.2.6
2025-02-19
​

  • 图片 Image 预览新增下载图片操作；新增 disabled / previewImageStyle 属性，支持禁用预览与自定义预览图样式
  • 优化 下载文件 downloadFile 工具函数的实现

2.2.5
2025-02-18
​

  • 进度条 Progress 的 lineCap 类型调整为 'round' | 'butt'
  • 二维码 QRCode 新增 type / icon / iconSize 属性与 getQRCodeImage() 方法：支持 svg / canvas / image 三种渲染类型、中央图标及其尺寸自定义、导出二维码图片

2.2.4
2025-02-17
​

  • 组件库及文档代码优化

2.2.3
2025-02-14
​

2.2.2
2025-02-13
​

2.2.1
2025-02-12
​

  • 优化自动按需引入解析器 VueAmazingUIResolver：使用自动按需引入时一并注入组件库全局默认样式
  • 组件库及文档代码优化

2.2.0
2025-02-11
​

2.1.8
2025-02-10
​

2.1.7
2025-02-07
​

  • 优化 徽标 Badge，将属性 ripple 默认值调整为 false
  • 组件库及文档代码优化

2.1.6
2025-02-06
​

  • 优化 选择器 Select 交互，自动记录下拉面板滚动位置
  • 组件库及文档代码优化

2.1.5
2025-02-05
​

  • 移除「自动引入样式」的接入方式，改用自动按需引入
  • 优化自动按需引入解析器 VueAmazingUIResolver，关闭 #29
  • 组件库及文档代码优化

2.1.4
2025-01-22
​

2.1.3
2025-01-21
​

2.1.2
2025-01-20
​

2.1.1
2025-01-17
​

  • 组件库及文档代码优化

2.1.0
2025-01-16
​

2.0.12
2025-01-15
​

2.0.11
2025-01-14
​

2.0.10
2025-01-13
​

2.0.9
2025-01-10
​

  • 文字滚动 TextScroll 的 pauseOnMouseEnter 默认值调整为 false，文档示例同步更新
  • 组件库及文档代码优化

2.0.8
2025-01-09
​

2.0.7
2025-01-07
​

2.0.6
2025-01-06
​

  • 对话框 Dialog 新增 destroyOnClose / scrollbarProps 属性，支持关闭时销毁子元素、固定高度时使用滚动条并自定义样式
  • 模态框 Modal 新增 destroyOnClose 属性，支持关闭时销毁子元素
  • 组件库及文档代码优化

2.0.5
2025-01-03
​

  • 优化 复选框 Checkbox 的点击动画
  • 优化 单选框 Radio 的组件实现
  • 表格 Table 的 scroll 新增 initialScrollPositionOnChange（分页 / 排序变化后是否回到初始位置），并新增 rowSelection 属性支持列表项选择（详见 Selection Type）
  • 组件库及文档代码优化

2.0.4
2024-12-30
​

  • 水印 Watermark 新增 fixed 属性，支持固定全屏水印
  • 组件库及文档代码优化

2.0.3
2024-12-26
​

  • 倒计时 Countdown 的 finishedText 属性更名为 finish
  • 修复 搜索框 InputSearch 使用插槽自定义搜索图标不生效的问题
  • 更新使用者文档：所有支持插槽的组件补充 Slots 说明
  • 组件库及文档代码优化

2.0.2
2024-12-24
​

  • 浮动按钮 FloatButton 的 icon 属性新增 VNode 类型
  • 新增 VueAmazingUIStyleResolve 导出，配合 vite-plugin-style-import 实现按需自动引入组件样式（见自动引入样式）
  • 组件库及文档代码优化

2.0.1
2024-12-20
​

2.0.0
2024-12-18
​

  • 所有组件支持手动或自动按需引入，全面支持基于 ES modules 的 tree shaking
  • 新增 VueAmazingUIResolver 导出，配合 unplugin-vue-components 支持自动按需引入（见自动按需引入）
  • 组件库及文档代码优化

1.10.4
2024-12-10
​

1.10.3
2024-12-09
​

  • 表格 Table 新增 sticky 属性，支持长表格固定表头与水平滚动条
  • 文字滚动 TextScroll 的 scrollText 属性更名为 items，移除 interval / step、新增 speed 控制水平滚动速度，并新增 pauseOnMouseEnter 属性控制鼠标移入暂停
  • 组件库及文档代码优化

1.10.2
2024-12-05
​

  • 播放器 Video 新增 iconSize 属性与 play() / pause() 方法，showPlay 属性更名为 playIcon

1.10.1
2024-12-04
​

  • 优化类型声明文件导出
  • 组件库及文档代码优化

1.10.0
2024-12-03
​

  • 新增类型声明文件，提供所有组件的类型定义导出，改善 TypeScript 开发体验
  • 组件库及文档代码优化

1.9.12
2024-12-02
​

  • 折叠面板 Collapse 的 collapseData 属性更名为 items，新增 collapseStyle / copyText / copiedText 等属性，支持自定义样式、箭头图标与复制按钮文本，并支持单个面板独立配置
  • 时间轴 Timeline 的 timelineData 属性更名为 items

1.9.11
2024-11-28
​

  • 修复组件库 vue-amazing-ui@1.9.10 更新 vite 至 v6 后，打包时 cssFileName 默认值更改为 package.json 中的 name 值导致无法引入 css 文件的相关问题

1.9.10
2024-11-28
​

1.9.9
2024-11-27
​

1.9.8
2024-11-26
​

  • 滚动条 Scrollbar 新增 yScrollable 属性与 --scrollbar-* 变量，支持关闭垂直滚动、自定义滚动条样式
  • 表格 Table 新增 rowClassName / showSorterTooltip / sortDirections / tooltipProps 属性与 expand / expandedRowsChange 事件，columns 支持 align / className / key / children 及排序相关配置（含表头分组、默认排序、受控排序）
  • 文字提示 Tooltip 新增 contentClass / showControl 属性
  • 气泡卡片 Popover、弹出确认 Popconfirm 新增 keyboard 属性，默认支持按键操作
  • 组件库及文档代码优化

1.9.7
2024-11-20
​

  • 滚动条 Scrollbar 新增 xPlacement / yPlacement 属性与 getScrollData() 方法，horizontal 属性更名为 xScrollable，scrollend 回调新增 direction 参数
  • 表格 Table 新增 scrollbarProps 属性，所有滚动改用 滚动条 Scrollbar 并支持其属性配置
  • 新增 滚动监测 useScroll 工具函数，移除 useScrollDirection
  • 组件库及文档代码优化

1.9.6
2024-11-15
​

  • 选择器 Select、分页 Pagination 新增 size 属性，支持设置尺寸
  • 表格 Table 新增 size / striped / scroll / ellipsisProps 与展开列相关属性，支持三种尺寸、斑马条纹、固定表头与固定列、展开行、可编辑单元格等
  • 组件库及文档代码优化

1.9.5
2024-11-13
​

1.9.4
2024-11-08
​

1.9.3
2024-11-06
​

1.9.2
2024-11-04
​

  • 对话框 Dialog、模态框 Modal 新增 titleStyle / contentStyle / bodyClass / bodyStyle / maskStyle / transformOrigin / blockScroll / keyboard / maskClosable 等属性并移除部分原有属性，支持控制动画出现位置、打开时禁用背景滚动、Esc 关闭、点击蒙层关闭与各层样式
  • 组件库及文档代码优化

1.9.1
2024-10-31
​

1.9.0
2024-10-30
​

1.8.10
2024-10-25
​

  • 文字提示 Tooltip 新增 tooltipClass / placement 属性，支持自定义弹出位置与类名
  • 修复 标签页 Tabs 左右切换时页面短暂出现滚动条的问题
  • 组件库及文档代码优化

1.8.9
2024-10-24
​

1.8.8
2024-10-22
​

  • 头像 Avatar 新增 href / target 属性，支持链接跳转
  • 文字滚动 TextScroll 新增 hrefHoverColor 属性，支持自定义链接悬浮颜色
  • 组件库及文档代码优化

1.8.7
2024-10-21
​

  • 上传 Upload 新增 drop / preview 事件回调，beforeUpload 支持返回 Promise 控制上传
  • 优化 加载中 Spin 的组件实现
  • 组件库及文档代码优化

1.8.6
2024-10-18
​

1.8.5
2024-10-17
​

1.8.4
2024-10-16
​

  • 评分 Rate 支持键盘左右键操作评分
  • 组件库及文档代码优化

1.8.3
2024-10-15
​

  • 单选框 Radio 新增 checked / width / height 属性，调整 gap 属性相关功能
  • 评分 Rate 新增 tooltips / tooltipProps 属性，支持设置文案提示
  • 组件库及文档代码优化

1.8.2
2024-10-14
​

1.8.1
2024-10-11
​

1.8.0
2024-10-10
​

1.7.2
2024-10-09
​

1.7.1
2024-10-01
​

1.7.0
2024-09-28
​

  • 标签页 Tabs 新增 prefix / suffix / animated / tabGutter / tabStyle / tabPosition / contentStyle 属性

1.6.9
2024-09-26
​

  • 标签页 Tabs 支持带图标的标签页
  • 组件库及文档代码优化

1.6.8
2024-09-24
​

1.6.7
2024-09-18
​

  • 组件库代码优化

1.6.6
2024-09-13
​

1.6.5
2024-09-10
​

1.6.4
2024-09-06
​

1.6.3
2024-08-30
​

1.6.2
2024-08-29
​

  • 对话框 Dialog 的 top 属性新增 string 类型
  • 水印 Watermark 新增 textStyle 属性，移除 color / fontSize / fontWeight / fontFamily / fontStyle 属性
  • 折叠面板 Collapse 新增 disabled / itemStyle / headerStyle / contentStyle / arrow / arrowStyle / extra 属性
  • 组件库及文档代码优化

1.6.1
2024-08-27
​

  • 文字提示 Tooltip 新增 bgColor / tooltipStyle / arrow / trigger / showDelay / hideDelay / show 属性
  • 气泡卡片 Popover 新增 titleStyle / contentStyle / bgColor / popoverStyle / arrow / trigger / showDelay / hideDelay / show 属性
  • 弹出确认 Popconfirm 新增 titleStyle / descriptionStyle / bgColor / popconfirmStyle / iconStyle / arrow / trigger / showDelay / hideDelay / show 属性
  • 优化 输入框 Input 的组件实现
  • 组件库代码优化

1.6.0
2024-08-23
​

1.5.4
2024-08-22
​

1.5.3
2024-08-19
​

1.5.2
2024-08-16
​

1.5.1
2024-08-15
​

  • 优化 列表 List 的组件实现
  • 组件库代码优化

1.5.0
2024-08-14
​

1.4.7
2024-08-13
​

1.4.6
2024-08-08
​

1.4.5
2024-08-07
​

1.4.4
2024-08-05
​

1.4.3
2024-08-02
​

1.4.2
2024-08-01
​

1.4.1
2024-07-31
​

  • 标签 Tag 新增 spaceProps 属性
  • 图片 Image 新增 spaceProps / spinProps 属性并移除部分原有属性
  • 上传 Upload 新增 spaceProps / spinProps / imageProps / messageProps / actionMessage 属性并移除部分原有属性
  • 优化 按钮 Button 的组件实现
  • 组件库及文档代码优化

1.4.0
2024-07-30
​

1.3.4
2024-07-29
​

1.3.3
2024-07-26
​

1.3.2
2024-07-26
​

1.3.1
2024-07-25
​

1.3.0
2024-07-24
​

1.2.0
2024-07-23
​

1.1.2
2024-07-22
​

1.1.1
2024-07-19
​

1.1.0
2024-07-18
​

future ​

  • 新增 穿梭框 Transfer 组件
  • 新增 漫游式引导 Tour 组件

Released under the MIT License.

Copyright © 2023-present the Muse Catcher