Skip to content

fix: align frozen-row scrolling and restore tree header address columns - #5362

Merged
Rui-Sun merged 3 commits into
developfrom
codex/fix-frozen-row-scroll-geometry
Nov 2, 2026
Merged

Rui-Sun merged 3 commits into
developfrom
codex/fix-frozen-row-scroll-geometry

Conversation

@Rui-Sun

@Rui-Sun Rui-Sun commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

🤔 这个分支是...

  • Bug fix
  • 测试 case 更新
  • 网站/文档更新

🔗 相关 issue 连接

来源为已有 BugServer 用例,未新增平台用例:

  • 6a1416f2709fdc006857f1dc:冻结行与滚动后的表头选择、绘制坐标和命中记录。
  • 6855015beb13a600a741dd62:空数据 extensionRows 树形表头的路径反查。

💡 问题的背景&解决方案

  1. 当 frozenRowCount: 5,初始化选择表头并调用 setScrollTop(10000) 后,滚动条跳转可能使图元比公开坐标向下偏移 160px,导致屏幕记录与命中记录相差四行。节点新建、内容刷新原先以表头底部为原点,虚拟滚动却以冻结区底部为原点;现在统一使用冻结区底部,并让空列创建复用同一坐标方法。
  2. 空数据树形透视表配置 extensionRows 后,getCellHeaderPaths(1, 2) 经对象形式的 getCellAddressByHeaderPaths 反查只返回 {row: 2}。树形分支匹配到行之后没有补齐默认列;现在根据匹配终点在布局 ID 数组中的实际列位置,加上左侧序号列偏移,返回 {col: 1, row: 2}。同时提供行列路径定位表体时,仍以匹配到的表体列为准。

树形 extensionRows 中,同一行不同表头单元格可能返回相同的完整路径。反查定位路径中最深的匹配节点,不承诺恢复最初查询路径时的列号;中英文 API 文档已说明这一边界。

本 PR 保留三个相邻缺口,不扩大修复范围: 数组形式参数对扩展维度的处理、rowHeaderTitle + extensionRows 的路径生成、包含 dataValue 的扩展路径顺序匹配。

📝 Changelog

Language Changelog
English Align frozen-row body coordinates during creation, refresh and virtual scrolling. Restore physical tree row-header columns in matched path addresses, including left series-number offsets.
中文 统一冻结行场景的节点创建、刷新与虚拟滚动坐标;补齐已匹配树形表头路径的实际列号及左侧序号列偏移。

☑️ 自测

当前提交:5d7cc21dcd451a8f678e5125d74c975503e2694f。已合入官方 develop@55bbff0dfec715aaa41c5ee782aa94445614e527,使用其更新后的离线依赖快照校验与 Playwright 运行器验证。Node.js:22.22.2。

  • 新增及相关透视表单测:4 个套件、52 项通过;冻结行及相邻滚动 API 单测:5 项通过。
  • 推送前钩子 rush test --only tag:package 通过;其中 VTable 为 86 个套件、451 项通过。
  • 合并后的测试环境自检:113 项通过。
node --test packages/vtable/scripts/visual-test.test.mjs packages/vtable/scripts/visual-dependencies.test.mjs packages/vtable/scripts/visual-regression.test.mjs
  • 两个业务视觉用例均先通过单例自比较;透视表目录 29 例的当前版全部通过,其中 28 例与基线一致,地址回归为旧版断言失败、新版通过。
  • 合并后全量比较完整执行:当前版 207 例全部通过,205 例与官方基线像素一致,0 项实际图像差异、0 项执行错误、0 项未运行。两个缺陷回归在旧版触发显式业务断言,在当前版通过,因此报告整体状态为 diff,两例标记为 new_baseline;这不代表两例完成了像素基线比较,也未自动更新或采用新基准图。
node packages/vtable/scripts/visual-test.mjs --baseline 55bbff0dfec715aaa41c5ee782aa94445614e527 --offline

离线命令要求预先准备匹配各侧提交的依赖和 Chromium;也可执行默认全量命令,获取官方 develop 并分别构建。

业务复验使用独立目录保留证据:原始滚动配置的三个场景在两种布局等待条件下各执行 30 次,共 180 个独立上下文,坐标偏差为 0、命中记录一致、各组截图一致;原始 extensionRows 配置分别在旧构建和修复构建各执行 5 次,旧版均缺列号,修复版均返回 {col:1,row:2} 并触发原 DARK 主题条件。两项修复提交之后仅合并测试环境改动,合并后的 SDK 构建 SHA-256 与原固定修复构建一致。

预期视觉变化及核查:滚动场景在两种初始布局调度下显示相同记录且与几何、命中一致;地址场景在原条件通过后切换 DARK 主题。已查看本地原始截图及 HTML 报告并核对业务状态,未将原始业务素材或本地路径上传到公开 PR;公开仓库内提供匿名化用例及明确业务断言供复现。

未执行:BugServer 线上固定构建复验及 photo 重新准入,仍需项目维护者核查;不得将本地通过视为线上 Photo 通过。本次启动的浏览器、服务和测试进程均已清理。

  • 已说明本次测试结果,以及未运行项目和原因。
  • 文档已更新。
  • Demo 无需更新。
  • TypeScript 类型定义无需更新。
  • 已提供两项 patch changelog。

🚀 Summary

copilot:summary

🔍 Walkthrough

copilot:walkthrough

VisActor 工作流(CN):blocked

当前提交:5d7cc21dcd451a8f678e5125d74c975503e2694f

三项检查建议与 BugServer 人工确认

@visactor-review-bot

visactor-review-bot Bot commented Oct 31, 2026 •

Copy link
Copy Markdown

VisActor 工作流

结论:流程受阻,请处理待办事项。
当前提交:5d7cc21;比较基线:55bbff0。
环境:CN;更新时间:2026-11-11T13:42:19.333Z。

检查项 状态 关键结果
CR ✅ passed 待处理 0;接受风险 0 查看结果
单测 ✅ passed 必要单测 job 必须实际执行并成功 查看结果
Playwright ⏳ differences_explained 截图 207;匹配 205;差异 2(已解释 2);错误 0
Photo(原 BugServer / UNIC) ✅ passed 用例 1410;截图 2227;匹配 2227;差异 0(已解释 0);错误 0

Photo 独立报告:流程完成不代表 Photo 通过。 Photo 自动执行并展示原始结果;差异解释仅作非阻断建议,强制门禁和标准图更新保持关闭,需管理员人工核查。

已人工合入;Photo 自动标准图更新已暂停,未满足的合入前条件不会由事后批准追认。
Bot 仅提供 CR、单测、Playwright 三项检查建议,不强制阻止合入。
未 Approve,可直接 Merge。

Photo 执行明细

Photo 原始执行:completed;结果:passed;缺少基准 0;等待 0;运行中 0;不完整 0;创建未知 0。

图片差异解释(2 项)
  • playwright / 空数据扩展树路径反查完整地址与主题切换(可接受):当前截图中空数据扩展树 A/B、G1/G2、I1–I4/Total 完整绘出且切为 DARK 主题;旧版 baselineErrors 为 verify 业务断言 CASE_ASSERTION_FAILED,第 1 行反查仅返回 {row:1},缺 col=1,故无旧图。用例冻结供两侧执行,当前版先逐行逐列验证地址和主题条件再截图,current passed;实现按匹配布局 ID 实际列位置加序号列偏移,符合预期修复。旧版断言没有删除或弱化。属可接受的新基准,非已完成像素基线对比。
  • playwright / 冻结行虚拟滚动后绘制、坐标与命中一致,表头选择不回跳(可接受):当前截图冻结行 Item 1–4 与表头在顶部,Group 列被高亮,滚动区 Item 736–740 连续无缺失;baselineErrors 为同一冻结用例 interaction 业务断言失败,row 740 的绘制位置 365 与公开坐标 205 相差 160px,故无旧图。旧实现以表头高度为表体原点;当前以冻结区底部为原点,空列创建也复用该坐标。当前用例仍实际滚动到 10000、点击滚动条并验证推进,再点击表头验证滚动值、选区并反复核对绘制、命中、记录文本;current passed 且截图在 verify 后生成。断言被强化而非删弱,符合修复目的;属新基准,不能宣称已有像素比较。
合入后 Photo 基准更新清单

自动标准图更新已暂停。

版本与合入后状态

当前提交:5d7cc21dcd451a8f678e5125d74c975503e2694f;比较基线:55bbff0dfec715aaa41c5ee782aa94445614e527。

合入后状态:anomaly。

CN 结果仅证明上述实际范围;完整报告和原始差异继续保留。

@visactor-review-bot visactor-review-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

未发现可确认的新问题。

@Rui-Sun
Rui-Sun merged commit d085f72 into develop Nov 2, 2026
9 checks passed
@Rui-Sun
Rui-Sun deleted the codex/fix-frozen-row-scroll-geometry branch November 2, 2026 10:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant