Skip to content

test(web): 多页签浮层补整页滚动 / 刷新恢复 / 菜单贴底的回归测试(#421) - #436

Merged
yile2020 merged 2 commits into
mainfrom
test/issue-421
Nov 22, 2026
Merged

yile2020 merged 2 commits into
mainfrom
test/issue-421

Conversation

@yile2020

Copy link
Copy Markdown
Owner

Closes #421

守的是什么

TabOutlet 把 URL 驱动的抽屉 portal 挂进本页签根节点(useTabPortalContainer),后台时抽屉跟着页签隐藏、状态保留。已有的 workflow.spec.ts「填到一半切走再切回来」只在默认的内容区滚动下验了应用内切换。这次补 issue 列的几种边界。

新增 apps/web/e2e/tests/tab-overlay-boundary.spec.ts(6 条 = 3 个场景 × page / content 两种滚动方式)

场景 断言
后台页签里开着的抽屉(审批「发起」?start=) 打开时确实锁着滚动;切到用户管理后:抽屉隐藏、没有滚动锁、前台不在 inert / aria-hidden 下、行操作菜单点得开、滚轮按模式滚对那一层(page 看 window.scrollY,content 看视口不动、内容层动)、铃铛面板挂 <body> 能开能关、焦点回到铃铛;切回来后抽屉可见,是同一个输入节点(打了记号,避免被草稿恢复蒙过去)、值还在、滚动锁重新拿上
刷新后从 sessionStorage 恢复的后台页签 恢复后前台不受影响(同上一组断言);点回去抽屉出现;再切走一次仍然隐藏、前台可用
贴着滚动区底边打开行操作菜单 菜单不在任何 [data-tab] 里、完整落在视口内、每个可点项中心的 elementFromPoint 都是它自己、焦点进菜单 / ↓ 可走 / Esc 回到触发器、打开关上前后滚动位置不变

每条都先红后绿(变异实测)

私有环境:api :8421 → fba_i421_test(PostgreSQL)+ 一次性 Redis :6421,web :1421,临时 playwright 配置(已删)。每个变异改完后按单条用例逐个跑,改回再跑全绿。

变异 结果
M1:start-sheet.tsx 的 container={container} → undefined(撤掉修复,portal 回 <body>) 「后台抽屉」两种模式都红在 expect(sheet).toBeHidden()(Received: visible);「刷新恢复」两种模式都红在再切走那一步的 toBeHidden()
M2:TabOutlet 用 display:none 的 div 代替 <Activity>(隐藏页签保留 effect) 「后台抽屉」「刷新恢复」四条都红在「后台抽屉不该还拿着滚动锁」
M2 + 临时去掉滚动锁那句断言 page 模式红在「前台应该能滚」,content 模式通过,说明用例能区分两种模式;而且前台照样点得动,只断言「能点」抓不到这个问题
M3:下拉菜单 portal 改进可见页签 「菜单贴底」两种模式红在「不在 [data-tab] 里」那句
M3c:菜单 Positioner 加 collisionAvoidance={{ side: 'none' }}(不翻转) 「菜单贴底」两种模式红在「第 3 项被别的东西盖住了」(菜单压成约 62px 高、内部滚动,后两项看不到)

改回之后:新文件 6 条 --repeat-each 2 12/12 绿;连同 tabs / tab-isolation / session-tabs / overlay-leave / page-overflow / workflow / notice-reach 一起跑 43/43 绿。pnpm typecheck --force · pnpm lint · pnpm arch:check · pnpm ctx:check 都过。

实测出来的新结论(已写进 packages/platform/src/shell/AGENTS.md)

  • 滚动锁只在整页滚动模式下伤人,表现是前台滚不动,但点击正常
  • Base UI 的滚动锁不一定加 data-base-ui-scroll-locked:覆盖式滚动条、页面没溢出时,只在 <html> / <body> 上写内联 overflow: hidden。用例第一版只认这个属性,在打开抽屉时就红了
  • 刷新后恢复到后台的页签,URL 抽屉根本没挂上(?start= 在,wf-start-sheet 节点 0 个,去掉 container 也一样):Base UI 靠 effect 建 portal 节点,hidden 的 <Activity> 不跑 effect。原始 bug 的现场是「刷新后那页正开着、再切走」,所以用例两段都测
  • 推翻了分册里「菜单挂进内容区会被裁」的推断:把菜单 portal 临时改进可见页签,贴底菜单照样完整、在最上层。原因没细查。挂 <body> 的理由改写成「浮层不该跟着页签一起隐藏、一起滚动」
  • 加了一张 portal 容器策略表:URL 抽屉挂本页签,外壳的铃铛 / 帮助 / 用户菜单挂 <body>,页面下拉菜单挂 <body>

没覆盖的

  • 用的是审批「发起」抽屉。其余 URL 抽屉(审批详情、公告读者 / 阅读统计、AI 预审统计)用同一个 useTabPortalContainer,没逐个写用例
  • 铃铛那几句断言没单独做变异(它不在页签里,M1–M3 都碰不到它)
  • 没测窄屏 / 移动端视口和真实触摸滚动;滚轮用的是 Playwright 的 mouse.wheel
  • 本地只在 PostgreSQL 上跑过,CI 跑在 SQL Server 上。用例只读,不建删用户

🤖 Generated with Claude Code

yile2020 and others added 2 commits November 22, 2026 08:01
- 新增 tab-overlay-boundary.spec.ts,滚动方式 page / content 各跑三条:
  后台页签里开着的 URL 抽屉不锁滚动、不挡前台、切回来同一个输入节点和值都在;
  刷新后从 sessionStorage 恢复的后台页签不挡前台,点回去再切走仍隐藏;
  贴底的行操作菜单挂 <body>、完整可见、逐项在最上层、焦点进出正确、不改滚动位置
- 滚动锁两条实现都认(属性 / 覆盖式滚动条下只写内联 overflow)
- shell 分册:补 portal 容器策略表;推翻「菜单挂进内容区会被裁」的推断;
  记下后台恢复的抽屉根本不挂、滚动锁只在整页模式伤人

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…al 连坐 · 注释与分册证据对齐实测(#421)

- afterAll 先 DELETE 本用例自动存下的 admin 发起草稿:草稿列表不看定义停没停用,原来每跑一次往共享库多留一份(实测私有库里留了 2 条)
- beforeAll 断言 publish 返回 published=true,校验不过时不再六条全晚到 wf-start-sheet 才红
- 「↓ 能走」改为断言焦点落在 role=menuitem 上:原断言打开时焦点就在弹层里,去掉 ↓ 照样绿(变异实测:新断言红)
- 焦点进菜单 / inert / 铃铛不在 [data-tab] 的一次性读改成 expect.poll
- describe.configure 由 serial 改 default:同一 worker 顺序跑、beforeAll 只建一份,但 page 模式红不再把 content 三条连带跳过
- 文件头 / 刷新用例注释改成实测行为(恢复到后台时抽屉没挂,portal 容器靠后半段守);滚动锁描述指向 pageLocked
- shell 分册策略表:只实测了审批「发起」,其余 URL 抽屉标为推断

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@yile2020
yile2020 merged commit 20f74bd into main Nov 22, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

多页签浮层补充整页滚动与弹层边界回归测试

1 participant