Codex
79 lines
2.8 KiB
Markdown
79 lines
2.8 KiB
Markdown
# 功能变更 ID: Feature-20260415-0008
|
||
|
||
> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
|
||
> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
|
||
|
||
## 基本信息
|
||
|
||
- ID: Feature-20260415-0008
|
||
- 标题: KEY5 第二阶段专项回归场景增强
|
||
- 状态：已完成
|
||
- 类型：修改
|
||
- 级别：L2 中等
|
||
- 模块: 测试用例 / 回归场景
|
||
- 版本 / 分支: 当前工作区
|
||
- 环境: Windows + EasyX
|
||
- 负责人: Codex 协作修改
|
||
|
||
## 变更背景
|
||
|
||
- 背景:
|
||
- 旧版 `KEY5` 已能覆盖第一阶段布局主线，但场景层次不够集中，说明文字偏长，部分区域排版紧。
|
||
- 第二阶段引入了内容驱动、overlay 补画、容器职责边界等新验证点，旧 `KEY5` 覆盖不完整。
|
||
- 目标:
|
||
- 把 `KEY5` 重构成第二阶段专项回归入口。
|
||
- 增加三层 `Canvas` 嵌套、通用 overlay、跨容器 hover 清理、`Label` 内容驱动规则验证。
|
||
- 不做什么：[可选]
|
||
- 不追求视觉美化。
|
||
- 不把测试用例变成完整 demo 页。
|
||
|
||
## 变更内容
|
||
|
||
- 变更摘要:
|
||
- 重构 `KEY5` 的区域布局与说明文案。
|
||
- 引入三层嵌套 `Canvas` 场景。
|
||
- 增加 `Window / Canvas / TabControl / Table` 四类关键回归点。
|
||
- 新增项：[可选]
|
||
- 三层 `Canvas` 嵌套与多层锚点链回归。
|
||
- `Label` 文本变化 / 样式变化按钮。
|
||
- 跨容器相邻按钮 hover/tooltip 回归点。
|
||
- 顶层浮层覆盖 `Table` 的 overlay 回归点。
|
||
- 修改项：[可选]
|
||
- 缩短说明 `Label` 文案，减少普通排版重叠。
|
||
- 重新组织分区顺序，提升单区可读性。
|
||
- 删除 / 废弃项：[可选]
|
||
- 删除过长、重复的说明文案。
|
||
- 受影响的文件 / 类 / 函数:
|
||
- [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/app/z-testDome.cpp)
|
||
- 对外 API / 属性变化：[可选]
|
||
- 无
|
||
|
||
## 行为对照
|
||
|
||
- 变更前:
|
||
- `KEY5` 主要覆盖第一阶段布局规则，层次和交互链回归点相对分散。
|
||
- 说明文字较长，部分区域排版偏挤。
|
||
- 变更后:
|
||
- `KEY5` 成为第二阶段主回归入口。
|
||
- 三层嵌套、overlay、跨容器 hover、`Label` 内容驱动、`Table` 分页与页码都能直接观察。
|
||
- 兼容性说明：兼容
|
||
- 迁移说明：[可选]
|
||
- 仍然通过 `#define KEY 5` 进入，无额外迁移。
|
||
|
||
## 验证与落地
|
||
|
||
- 验证方式:
|
||
- 编译 `z-testDome.cpp /DKEY=5`
|
||
- 手动观察窗口 resize、hover、tooltip、overlay、分页和 `Label` 变化
|
||
- 验证结果:
|
||
- 编译级验证通过
|
||
- GUI 手动验证待本机执行
|
||
- 关联 BUG / Fix：[可选]
|
||
- `BUG-20260415-0005`
|
||
- `Fix-BUG-20260415-0005`
|
||
- Commit: 未提交（当前工作区）
|
||
- PR：[可选]
|
||
- 发布版本：[可选]
|
||
- 备注：[可选]
|
||
- `Label` 样式变化验证明确依赖 `setDirty(true)` 使用约定。
|