更新日志
当前发布版本:v0.2.32,同步发布于 npm 与 Gitee。
ruanno-ui
0.2.32
Patch Changes
3771252: fix(focus): 选中/关闭弹层后把焦点还给触发器
- Dropdown:选中菜单项后焦点回触发器(此前菜单
v-show隐藏,焦点掉到 body) - DatePicker:选择日期/月份/年份、快捷项、「今天」、datetime 确认、Esc 关闭后焦点回触发器;Esc 栈回调改为
close(true) - TimeSelect:选中时间、Esc 关闭后焦点回触发器
- 新增 4 条焦点用例(Dropdown 键盘选中、DatePicker 点选/ Esc、TimeSelect 选中)
- Dropdown:选中菜单项后焦点回触发器(此前菜单
0.2.31
Patch Changes
3d73700: fix(form-item): 异步校验竞态,旧值的结果不再覆盖新值
validate增加序号:每次校验标记「最新一次」,await规则返回后若已过期就不再写error,并返回最新一次校验的结果clearValidate/resetField递增序号,让挂起的异步校验作废,避免它稍后把错误写回来- 新增「异步校验」示例(输入 admin 延迟 300ms 返回失败,带当前值回显)
- 补 2 条用例:旧值延迟返回、clearValidate 后延迟返回
0.2.30
Patch Changes
8be4c0d: fix(form): disabled 时用 inert 覆盖自定义控件
fieldset[disabled]只会原生禁用 input / button / select / textarea;Select、Cascader 等 div 触发器的自定义控件不在其列,原有pointer-events: none又只挡鼠标——键盘仍能 Tab 到触发器、Enter 打开下拉、方向键改值- Form 在
disabled时补inert与aria-disabled:整棵子树不可聚焦、不可交互,读屏也能获知禁用状态(保留 fieldset disabled 与 pointer-events 作为旧浏览器兜底) - 新增 1 条契约用例(inert / aria-disabled 随 disabled 切换)
0.2.29
Patch Changes
6cb69cf: fix(captcha): 受控状态补齐,表单重置能真的清空验证码
ClickCaptcha补modelValueprop:此前只emit("update:modelValue")不接收,父组件的v-model写入被当成普通 attr,外部 true/false 都不生效ClickCaptcha父组件改回 false 时清空点选进度(内部resetVisual不 emit,避免把父组件的值再打回去)SliderCaptcha挂载不再把外部modelValue=true洗成 false;补watch同步外部重置(恢复可拖动)与通过态(拼图块对齐缺口)- 新增 3 条受控用例;新增「表单重置」示例(重置按钮 + 状态回显)
0.2.28
Patch Changes
4dd9958: fix(tabs): modelValue 不匹配任何 item 时回落到首个可用项
activeName不再盲信外部modelValue:值不在 items 里时回落到首个可用项,整组始终有一个可视、可聚焦的 tab- items 动态变化(例如关闭当前标签)导致激活项消失时,同样拉回可用范围
- 文档示例初始值修正(
tab1="a"而 items 是intro/spec):roving tabindex 上线后,这种不匹配会让所有 tab 都变成tabindex=-1,键盘无法进入 tablist - 新增 2 条用例
0.2.27
Patch Changes
eda0be4: fix(tabs): tablist 键盘导航与 tabpanel 关联
- 整组只保留激活项一个 Tab 停靠点:激活 tab
tabindex=0,其余-1(原来每个可用 tab 都是停靠点,6 个标签要按 5 次 Tab 才能穿过去) - ←/→ 循环、Home/End 跳首尾,移动即激活并跟随焦点,自动跳过 disabled
- tab 与 tabpanel 补
id/aria-controls/aria-labelledby;paneltabindex=0可聚焦,焦点环改用主题色 - 可关闭标签支持 Delete 关闭,并补
aria-keyshortcuts="Delete";关闭图标改为aria-hidden,不再在 button 里嵌套role=button - 新增 5 条用例(停靠点、方向键、aria 配对、Delete、关闭图标语义)
- 整组只保留激活项一个 Tab 停靠点:激活 tab
0.2.26
Patch Changes
92a4acd: fix(carousel): 自动播放补暂停开关与轮播语义
- 自动播放时渲染暂停/继续按钮,DOM 顺序排在箭头与指示点之前——键盘 Tab 第一站就能停住;
aria-label与aria-pressed同步切换 - 轨道
aria-live:播放中off,暂停后polite,手动切页会被读屏播报 - 根节点
role="region"+aria-roledescription="carousel"+aria-label(新增 locale 键carousel.label/carousel.pause/carousel.play) - 指示点补
aria-current prefers-reduced-motion: reduce时默认暂停,用户可手动继续- 页面隐藏时停表,回到前台续播
- 自动播放时渲染暂停/继续按钮,DOM 顺序排在箭头与指示点之前——键盘 Tab 第一站就能停住;
0.2.25
Patch Changes
44eb911: fix(select): ↑ 打开时搜索框聚焦会抢走滚动位置
searchRef.focus()默认会把下拉滚动容器拉回顶部,把「按 ↑ 打开并高亮末项」的scrollIntoView结果顶掉(实测 scrollTop 81 → 0);改为focus({ preventScroll: true }),聚焦后再补一次高亮滚动- 补 1 条
scrollIntoView用例
0.2.24
Patch Changes
849451d: fix(select): 可搜索下拉的键盘导航与 ARIA
- filterable / remote 模式下焦点在搜索框时,↑/↓/Home/End/Enter/Esc 全部失效:键盘处理同时挂到下拉面板,搜索框的事件冒泡可达
- 补
aria-controls/aria-activedescendant,选项生成稳定 id(此前屏幕阅读器读不到高亮项) - 关闭状态按 ↑ 打开并高亮最后一个可用项;过滤后 ↑ 从末尾开始,不再落到倒数第二项
- Esc 或键盘选中关闭后把焦点还给触发器;高亮移动时
scrollIntoView,长列表不会「选中了但看不见」 - 搜索框
aria-label由写死的search改为 locale 文案
0.2.23
Patch Changes
- Dropdown 的下一帧聚焦加守卫:如果这一帧里已有别的弹层接管焦点(例如刚打开的命令式 MessageBox),不再把焦点抢回菜单项。修复「下拉菜单打开时弹出确认框,Esc 会连着关掉两层」的竞态。
0.2.22
Patch Changes
- 8cdd634: 修复命令式弹层(showConfirm/showAlert/showPrompt)创建时即打开、焦点陷阱却从未执行的问题:
useFocusTrap的 immediate watcher 在挂载前运行,容器 ref 尚不存在;新增 onMounted 补跑一次,真实浏览器中焦点才会进入面板。补充命令式与「下拉菜单打开时」两条焦点用例。
0.2.21
Patch Changes
5f1fdf9: 三个弹层的键盘监听改为「栈内处理」:
- DatePicker / Dropdown 移除 document 上的全局 Escape 监听,改接
useEscapeStack:与 Dialog 等叠层时 Esc 只关最上层,不再把下层面板一起关掉 - ImagePreview 的方向键从 document 移到面板自身:叠层时不会误改下层的预览索引
- 新增 3 条叠层回归用例(上层弹层打开时,DatePicker/Dropdown 不被 Esc 关闭、ImagePreview 不被方向键切换)
- DatePicker / Dropdown 移除 document 上的全局 Escape 监听,改接
0.2.20
Patch Changes
- ec25529: meta 契约审计扩展到 default / enum:解析源码
withDefaults的字面量默认值与类型里的字符串字面量联合,与meta.json比对;支持「有效默认」描述(CSS 变量/locale 回落/派生值)自动豁免。首轮比对 403 个默认值、38 组枚举,修掉 FormItem.label 缺失默认值,并把 RichTextEditor.placeholder 的默认值从说明文字规范为""(fetch 回落说明移入描述)。
0.2.19
Patch Changes
- 489a953: RadioGroup 改为 roving tabindex:整组只保留一个 Tab 停靠点(优先选中项,未选中时第一个可用项),方向键/Home/End 选中后停靠点跟随;单独使用的 Radio 仍固定为停靠点。顺带补
@types/node与 tsconfig types,修复 meta-parity 测试的类型检查报错。
0.2.18
Patch Changes
- da2872c: DatePicker 快捷选项补 min/max 校验:此前快捷按钮直接提交值,完全绕过
min/max(日期格禁用、按钮却可选),且按钮没有禁用态。现在越界的快捷项被禁用,点击回调再守一道;新增 1 条用例。
0.2.17
Patch Changes
- 9c9e9d6: DatePicker 修复「今天」基准不刷新:
todayString原来只在挂载时计算一次,单页应用跨天常驻时,重新打开面板会高亮昨天、点「今天」也选中昨天。现在每次打开面板刷新日期基准。同时补 4 条日历网格边界用例(周一起始补格、周日起始、闰年 2 月 29 天、12 月跨年补格)。
0.2.16
Patch Changes
- f960439: 新增
scripts/audit-meta.mjs与meta-parity.spec.ts:把组件源码里的 props / events / slots 与meta.json做静态比对,CI 跑测试即可发现契约漂移。首次全量审计 97 个组件,修掉唯一一处真实漂移(TabBar 的ariaLabel未登记进 meta)。
0.2.15
Patch Changes
- Tree 对
checkedKeys增加类型守卫:传入非数组(例如误传 boolean)时按空集合渲染,不再抛boolean true is not iterable把整个组件崩掉。同时修正文档示例的 v-model 标识符冲突(ck1与 Checkbox 演示同名,默认值是 boolean)。 - Tree 改为 roving tabindex:整棵树只保留一个 Tab 停靠点(此前每行都是 Tab 停靠点,8 行的树要 Tab 8 次才能穿过去)。方向键移动焦点时停靠点跟随;收起父级或数据变化后若停靠点落在不可见行,会自动回退到第一个可用行。
0.2.14
Patch Changes
a6513fe: AutoComplete 补齐键盘细节:首次按 ↓ 打开时直接高亮第一项(此前要按两次才移动),↑ 打开时高亮最后一项,补 Home/End 到列首/列尾;面板关闭时 Home/End 保留浏览器默认行为。
cf7be53: Cell 补可访问名称:
clickable时用title作为aria-label,label通过aria-describedby降级为描述(此前读屏会把标题、副标题、右侧值拼成一句很长的按钮名);不可点击时不下发这两个属性,保留列表项语义。8a25361: Dropdown 补键盘闭环:↓ 打开菜单并聚焦第一个可用项;菜单内 Esc 关闭并把焦点还原到触发器;Tab 关闭菜单但不拦截焦点移动。菜单 teleport 在 body 下收不到根节点事件,因此 Esc/Tab 也注册在菜单自身;聚焦改到下一帧执行,避免
v-show还是display:none时 focus 被忽略。aa4691d: Tree / TreeSelect 键盘补齐:
- Tree:行间补 ↑↓(循环)与 Home/End,跳过
disabled行;行自身原有的 Enter/Space 选择、→/← 展开收起保持不变 - TreeSelect:触发器 Enter/Space 可打开面板并把焦点送进树的第一行;在行上按 Esc 关闭并把焦点还给触发器;任何方式关闭时若焦点在面板内都会还原到触发器
- 触发器补
aria-haspopup="tree"/aria-controls - 新增 5 个用例(Tree 2、TreeSelect 3),全量 890 通过
- Tree:行间补 ↑↓(循环)与 Home/End,跳过
0.2.13
Patch Changes
8d47e7a: Cascader 补齐键盘导航:此前触发器只有 Esc 处理,Enter/Space 打不开面板(能 Tab 到但按不动)。
- Enter/Space 打开;↑↓ 在列内移动高亮(循环、跳过 disabled),Home/End 到两端
- → 进入子列、← 回到上列;Enter 提交叶子或展开父级,Esc 关闭并把焦点还给触发器
- 高亮通过
aria-activedescendant暴露;触发器补aria-haspopup="listbox"/aria-controls - 新增 6 个用例(开关、循环、Home/End、进出列、提交、跳过禁用),Cascader 20 个用例通过
0.2.12
Patch Changes
4a8a8d3: 补齐四个弹层组件的焦点陷阱:MessageBox / ImagePreview / Tour / ActionSheet 此前只接了 Esc 栈、没接
useFocusTrap,打开后焦点仍留在触发器上,Tab 会直接走到弹层背后的页面。useFocusTrap改为每次 Tab 重新收集可聚焦项(Tour 切步骤、MessageBox 出现输入框后不会指向已移除节点),并过滤hidden/aria-hidden/checkVisibility不可见节点- 焦点跑到容器外(点过地址栏再按 Tab)时拉回面板
- 四个组件补
panelRef接入,面板内 Tab/Shift+Tab 循环,关闭后焦点还原到打开前的元素
c5c9eee: Transfer 表头复选框补齐可访问性:半选态
aria-checked输出"mixed"(此前只说 true)、补tabindex="0"与 Enter/Space 激活,键盘用户可完成全选。5f1da99: 修复 Transfer 在搜索过滤下的第三个缺陷:过滤后点表头全选会用「可见项」整体替换已选集合,把看不见的已选项一起丢掉;现改为并集/差集增量更新,半选与勾选态也改为按当前可见项派生。
0.2.11
Patch Changes
- d140f70: canvas 类组件按设备像素比绘制:Watermark / ImageCaptcha / ClickCaptcha / SliderCaptcha 的位图改为
CSS 尺寸 × dpr(上限 3×)并配合background-size还原显示尺寸,修复高分屏(dpr≥2)下水印与验证码被拉伸发虚的问题。另补 6 个组件的第三个/第二个示例(含验证码暗色、禁用、表单联动)。 - 9d84268: 图表增加数据校验:LineChart / BarChart / HeatmapChart / ScatterChart 会跳过数值非法的数据点并在开发环境打印一次警告,避免渲染出
d="M40,NaN"、fill-opacity="NaN"这类无效 SVG(此前一个脏点会让整条折线或整块热力格失效)。新增 6 个图表 × 边界数据的回归用例 30 条。 - cc7de8c: 修复 Transfer 的两个选择态缺陷:① 部分选中时点表头复选框会把已选清空,现改为补齐全部可选项目;② 半选态的分母把禁用项算了进去,导致全选后仍显示半选,现按可选(非禁用)项计算。
0.2.10
Patch Changes
- f144e71: 补齐可交互元素的键盘入口:Cell 的 clickable 改为 role="button" + tabindex=0,Enter/Space 等价点击;Grid 的宫格项补 tabindex 与 Enter/Space 触发 item-click。此前两者只能鼠标点击。
- 00b00f3: TabBar 补导航语义:容器默认 aria-label(locale 文案「主导航」,可用 ariaLabel 覆盖),激活项标记 aria-current="page"。底部导航属于页面跳转而非 tab 控件,因此不采用 role="tablist"。
0.2.9
Patch Changes
- 73e12e0: 修复 ConfigProvider 的 size 完全不生效:Button 与 Input 的 size 改为未传时继承最近的 ConfigProvider,再回落到 md;补 4 个用例覆盖继承与显式覆盖。
- 08b01ba: Countdown 修复 duration <= 0 时 finish 永不触发的问题:初始已归零视为已结束,挂载即 emit finish;补充 2 个边界用例。
0.2.8
Patch Changes
- 579cac6: Radio 补齐无障碍语义与键盘导航:暴露 role/aria-checked/aria-disabled,禁用项退出 Tab 序列;RadioGroup 支持方向键与 Home/End 在组内移动并选中。
0.2.7
Patch Changes
- 修复 Affix 与 Anchor 在滚动容器内失效:Affix 改为捕获阶段监听 document 的 scroll 事件,同时覆盖 window 与所有 overflow 容器;Anchor 的高亮同步覆盖滚动容器。
0.2.6
Patch Changes
- 验证码与文档交互累计修复:SliderCaptcha 图像拼图与通过容差优化;ClickCaptcha 命中容差/字符避让/空白不重置、增加换一批刷新与通过状态提示、修复初始误选并增加 1/2/3 点选进度;文档「编辑并运行」自动展开编辑器,Playground 调参事件名统一为 update:modelValue。新增真实交互审计 11 项全部通过。
0.2.5
Patch Changes
- 049c0bf: ClickCaptcha 增加「换一批」刷新按钮与通过状态提示,保持命中容差与空白不重置;文档「编辑并运行」自动展开代码区,Playground 调参事件名统一为 update:modelValue(修复 Select/InputNumber/Input 调参失效)。新增 tests/e2e/interaction-audit.mjs 真实交互审计 11 项全部通过。
0.2.4
Patch Changes
- 786f41c: SliderCaptcha 视觉升级为真正的图像拼图:程序生成背景插画(渐变天空/山形/圆点),拼图块与缺口同源裁切,底部滑杆拖动对齐,保留 10px 通过容差与原有事件契约。真实浏览器拖动验证通过。
0.2.3
Patch Changes
- 1bc6c5f: 验证码组件可用性修复:SliderCaptcha 通过容差从 4px 放宽到 10px;ClickCaptcha 命中半径从 22px 放宽到 30px、字符放置避让避免重叠、点击空白处不再误判失败重置(仅点中非目标字符才刷新)。已通过真实浏览器拖动与点选验证。
0.2.2
Patch Changes
- 更新包元数据:repository 指向开源仓库 gitee.com/ruanno-top/ruanno-ui,homepage 指向已上线文档站 ui.ruanno.top。
- Updated dependencies
- @ruanno-ui/tokens@0.2.1
0.2.1
Patch Changes
- 717d8f2: 修复发布产物的依赖声明:将
@ruanno-ui/tokens的workspace:*协议改为正式版本号(^0.2.0),否则 npm 安装 ruanno-ui 时会报 EUNSUPPORTEDPROTOCOL。
0.2.0
Minor Changes
7612aaf: 新增 11 个组件:图表系列(LineChart / BarChart / PieChart / ScatterChart / HeatmapChart / GraphChart)、验证码系列(SliderCaptcha / ClickCaptcha / ImageCaptcha)、RichTextEditor、Grid;tokens 新增 chart-1 ~ chart-8 图表配色;resolver 同步内置组件清单。
同时修复 Calendar / DatePicker / Table / RichTextEditor / FormItem 中硬编码的中文 aria-label 与状态文案,全部接入 locale 语言包(zh-CN / en 同步补充对应键)。
ca74c16: 组件动效增强:
- 入场与数据动效:Statistic 数值滚动(挂载与值变化时,SSR 首帧渲染最终值避免闪烁,尊重 prefers-reduced-motion);LineChart / BarChart / PieChart 入场动画(线条描画、柱体生长、扇区浮现);三图表数据变化时按数据签名重挂载并重放入场动画;图表 tooltip 呼出上浮淡入(chart.css 统一)。
- 交互微动效:Switch 圆点切换 spring 缓动;Countdown 拆分单字符渲染,变化的数字以里程表方式滚动;Carousel 支持快甩(flick)翻页与非 loop 边缘橡皮筋阻尼;图表数据点 / 柱 / 扇区补 hover 指针与描边反馈;Statistic 趋势箭头延迟 spring 弹出。
- 规范治理:全库约 30 处硬编码缓动(
ease/ease-out/ease-in/ 手写cubic-bezier,含 IndexBar 内联的与--rn-easing-spring等值的曲线、SliderCaptcha 的0.3s ease)统一替换为--rn-duration-*/--rn-easing-*tokens。 - 真实浏览器验证与修复:新增
tests/e2e/real-motion-test.mjs(Playwright 真实 Chromium 交互测试 19 项)与tests/e2e/harness/(最小 Vite 验证页);修复 Statistic 滚动动画在 rAF 时间戳异常环境下出现负值闪烁的问题——进度统一以performance.now()计算并钳制到 [0,1]。
Patch Changes
- Updated dependencies [7612aaf]
- @ruanno-ui/tokens@0.2.0
0.1.0
Minor Changes
- 首个公开发布候选:93 个组件(跨端 + 5 套主题 + i18n + AI 可读契约)、v-loading / v-infinite-scroll 指令、unplugin 自动按需引入 resolver、SSR 兼容、Table 虚拟滚动/筛选/合计行/树形数据、DatePicker 全类型、Select/Cascader/TreeSelect 多选体系、MessageBox/Tour/Calendar/TimeSelect 等新组件。
Patch Changes
- Updated dependencies
- @ruanno-ui/tokens@0.1.0
@ruanno-ui/tokens
@ruanno-ui/tokens
0.2.1
Patch Changes
- 更新包元数据:repository 指向开源仓库 gitee.com/ruanno-top/ruanno-ui,homepage 指向已上线文档站 ui.ruanno.top。
0.2.0
Minor Changes
7612aaf: 新增 11 个组件:图表系列(LineChart / BarChart / PieChart / ScatterChart / HeatmapChart / GraphChart)、验证码系列(SliderCaptcha / ClickCaptcha / ImageCaptcha)、RichTextEditor、Grid;tokens 新增 chart-1 ~ chart-8 图表配色;resolver 同步内置组件清单。
同时修复 Calendar / DatePicker / Table / RichTextEditor / FormItem 中硬编码的中文 aria-label 与状态文案,全部接入 locale 语言包(zh-CN / en 同步补充对应键)。
0.1.0
Minor Changes
- 首个公开发布候选:93 个组件(跨端 + 5 套主题 + i18n + AI 可读契约)、v-loading / v-infinite-scroll 指令、unplugin 自动按需引入 resolver、SSR 兼容、Table 虚拟滚动/筛选/合计行/树形数据、DatePicker 全类型、Select/Cascader/TreeSelect 多选体系、MessageBox/Tour/Calendar/TimeSelect 等新组件。
@ruanno-ui/resolver
@ruanno-ui/resolver
0.1.2
Patch Changes
- 更新包元数据:repository 指向开源仓库 gitee.com/ruanno-top/ruanno-ui,homepage 指向已上线文档站 ui.ruanno.top。
0.1.1
Patch Changes
7612aaf: 新增 11 个组件:图表系列(LineChart / BarChart / PieChart / ScatterChart / HeatmapChart / GraphChart)、验证码系列(SliderCaptcha / ClickCaptcha / ImageCaptcha)、RichTextEditor、Grid;tokens 新增 chart-1 ~ chart-8 图表配色;resolver 同步内置组件清单。
同时修复 Calendar / DatePicker / Table / RichTextEditor / FormItem 中硬编码的中文 aria-label 与状态文案,全部接入 locale 语言包(zh-CN / en 同步补充对应键)。
0.1.0
Minor Changes
- 首个公开发布候选:93 个组件(跨端 + 5 套主题 + i18n + AI 可读契约)、v-loading / v-infinite-scroll 指令、unplugin 自动按需引入 resolver、SSR 兼容、Table 虚拟滚动/筛选/合计行/树形数据、DatePicker 全类型、Select/Cascader/TreeSelect 多选体系、MessageBox/Tour/Calendar/TimeSelect 等新组件。