Codex
55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
# BUG-20261009-0001
|
||
|
||
> 适用场景：记录问题本身，不展开完整修复方案。修复内容写入对应的 Fix 文档。
|
||
|
||
## 基本信息
|
||
|
||
- ID: BUG-20261009-0001
|
||
- 标题: Table 内部分页按钮焦点视觉延迟刷新
|
||
- 状态：已修复，自动回归通过，KEY1 人工复验待执行
|
||
- 严重性：S2
|
||
- 优先级：P1
|
||
- 模块: Focus / Table / Managed Repaint
|
||
- 版本 / 分支: `master`，阶段 3 实现提交 `29df994`
|
||
- 环境: Windows + EasyX + Routed 键盘生产路径
|
||
- 发现人: 用户 KEY1 人工回归
|
||
- 关联 Fix ID: Fix-BUG-20261009-0001
|
||
|
||
## 问题描述
|
||
|
||
- 现象: Tab 把逻辑焦点移入 Table 的分页 Button 后，焦点框不会立即出现；焦点离开后，旧焦点框也不会立即消失。只有 hover、翻页或其它原因再次触发表格重绘时，屏幕才与逻辑焦点状态一致。
|
||
- 影响范围: Table 内部上一页/下一页 Button 的全部逻辑焦点视觉；逻辑焦点身份和 Tab 顺序本身正确。
|
||
- 期望结果: 分页 Button 获焦和失焦都必须在当前输入批次的托管重绘收口中刷新整张 Table，不依赖下一次无关事件。
|
||
|
||
## 复现信息
|
||
|
||
- 前置条件: Table 已首次绘制并 materialize 分页 Button，当前页存在可用分页方向。
|
||
- 复现步骤:
|
||
|
||
1. 启动 KEY1。
|
||
2. 使用 Tab 把焦点移动到 Table 分页 Button。
|
||
3. 不移动鼠标、不触发其它控件，观察分页区。
|
||
4. 再按 Tab 离开分页 Button，继续观察分页区。
|
||
|
||
- 复现概率：人工回归稳定观察到
|
||
- 人工证据: 用户于 2026-10-09 的 KEY1 回归描述。
|
||
|
||
## 根因分析
|
||
|
||
- Table 分页 Button 是真实 `Button`，但它属于 Table 内部绘制单元，不能作为独立顶层重绘 root 提交。
|
||
- `Button::applyFocusState()` 只把内部 Button 自身标脏并请求重绘；Table 没有因此进入 dirty，外层 Canvas 的脏子树判断看不到需要重画的 Table。
|
||
- 逻辑焦点状态已更新，但屏幕继续保留上一帧，直到后续事件把 Table 自身标脏。
|
||
|
||
## 跟踪信息
|
||
|
||
- 首次发现时间: 2026-10-09
|
||
- 最后更新时间: 2026-10-09
|
||
- 修复版本: `29df994`
|
||
- 验证版本: Debug x64 定向 focus UI 3/3、完整 UI 1/1、四配置 67/67 与 KEY1–KEY6 编译通过
|
||
- 关联记录: `Module-20261009-0007`
|
||
|
||
## 关闭边界
|
||
|
||
- 自动像素测试已证明分页 Button 焦点框在 Tab 进入时即时出现、离开时即时清除。
|
||
- BUG 最终人工关闭仍需用户复验 KEY1；自动通过不替代该人工门槛。
|