ISSUE-0232 表格尾页越界 clamp¶
病灶¶
ISSUE-0229 审查 F8 定位:client 模式下行数收缩(筛选/聚合重建/删除/窗口收紧)
后 page 停在深页 → slice((page-1)*pageSize, ...) 越界 → 空表 + 页脚「第
501-200 条」破相文案;totalRows=0 时分页器整体隐藏无法导航回第 1 页。0229 的
epoch 失效曾使此缺口常态暴露(闪空时代已过去,退回边角,本刀收口)。
修法¶
- 引擎层(ui/data-table.tsx,T3 文件):client 模式
safePage = Math.min(page, maxPage),slice/页脚 rangeFrom/rangeTo/Pager 三处一处出口统一走 safePage;showFooter = totalRows > 0 || (clientMode && page > 1)(归零卡深页页脚不藏,正常空表 page=1 维持旧貌)。 server 模式零变化(!clientMode ⇒ safePage===page);onPaginationChange 契约不动;clamp 纯显示层不回写上游 page state(下次 onPageChange 自愈)。 - 姊妹路径(use-data-source.ts,ds 审出):商家快速模式走 useDataSource 的 clientPaged 切片(local-table 不传 clientMode)——引擎 safePage 不经过它,同款无 clamp。补同款显示层夹页(只夹 list 切片,不动 total/allIds/选择语义)。 2b. 页脚出口(local-data-view.tsx,ds 复验 P2):list 夹页后页脚仍按原始 page 算出「第 21-5 条」倒挂——page 传 LocalTable 前过 clientSafeDisplayPage(page,total,pageSize,mode)(client 才夹,server 原样), 纯函数放 local-data-view-predicates.ts(该文件头注本就「抽纯函数只为可判据」)。
- 测试:12 条渲染级用例(6 引擎+3 hook+3 页脚接线)(jsdom+testing-library,走 ./render-app 统一 入口)——深页收缩回第 1 页/归零页脚可导航/正常页不受影响/server 深页 倒挂既有行为钉住(另账治理)/快速模式切片夹页。mutation:去 clamp → 「Unable to find 行01」红(主控独立复现)。
审查记录¶
T3 三席(矩阵分段:luna 先审 → GO 后 glm+ds 并行):luna GO-WITH-WARNINGS (diff 范围与 mutation 两 UNVERIFIED 由主控独立补证闭合);glm GO(P3 尾巴: server 深页倒挂文案另账/归零改 pageSize 页脚消失边角/maxPage=1 窄面板仅禁用 Pager 形态/出口负断言与 sortModel×深页补测方向);ds NO-GO 抓出姊妹路径 缺口(useDataSource client 切片)+版本/devlog 收口缺口(主控 docs 步补)→ 整改(D1 夹页+D2 测试入口+D3 页脚夹页)→ ds 复验 GO-WITH-WARNINGS。主控独立复跑:compile 0、全量测试绿、 mutation 红/绿复现。
尾巴(P3 记账)¶
- server 模式深页倒挂文案「第 21-5 条」为既有行为(被用例钉住防回归)—— 归上游 hook 治理,单开账;
- 归零卡深页时改 pageSize 后页脚消失(宽面板边角);maxPage=1 且窄面板仅剩 全禁用 Pager(quickFilter 变更会 setPage(1) 自愈,非卡死);
- showFooter 新条件分支未进 tests/layout harness 矩阵——jsdom 行为级已覆盖, 显示层分支不改滚动/高度链,L2 实测证据未触发(判断记录在案);
- product 文档已补「列表变短时自动回到最后一个有效页」一句;
- dist manifest 版本落后(0.16.81 vs 0.16.85)——发版时 build 对齐(既有 漂移,非本刀引入)。