35 lines
2.4 KiB
Markdown
35 lines
2.4 KiB
Markdown
---
|
||
id: T-408
|
||
title: 实例列表数据行 200% 高度与可访问密度
|
||
phase: 4
|
||
deps: [T-208, T-306, T-310]
|
||
status: DONE
|
||
created: 2026-07-28
|
||
owner: codex
|
||
---
|
||
|
||
## 需求与背景
|
||
|
||
实例列表当前以行内图标的自然高度决定数据行高度，长路径、状态文字和多个行操作在高 DPI、触控或快速点击时显得过于紧凑。用户要求将实例列表数据行高度增加到当前标准行的 200%。
|
||
|
||
## 方案与边界
|
||
|
||
- 将实例列表数据行的自然最小高度从当前 30 dp 提升为 60 dp（200%）；高度使用 Gio `unit.Dp`，因此继续遵循 Windows DPI 缩放。
|
||
- 只设置数据行的最小高度，并使既有文本、状态和操作区保持垂直居中；内容在 200% 缩放、中文长文本或未来更高控件时可自然扩展，禁止以固定最大高度裁切。
|
||
- 保留现有表头、列权重、行间距、列表虚拟化、行选择、双击/Enter 编辑，以及启动、编辑、删除按钮的顺序、标签、焦点和命中优先级。行内操作不冒泡为行操作。
|
||
- 使用命名布局常量和单元测试锁定“标准高度 × 2”的契约，避免未来图标尺寸变动意外缩小行高。
|
||
- 这是局部密度与可访问性调整，不新增信息架构、状态或可操作控件；因此无需修改已确认 HTML 原型。
|
||
|
||
## 验收要点
|
||
|
||
- 自动化：验证数据行最小高度为标准行高度的两倍，且现有列权重与操作布局契约不变。`go test ./internal/ui`、`go test ./...`、`go vet ./...`、`cmd /c build.bat` 通过。
|
||
- Windows smoke：在 100% 与 200% 缩放、窄窗口和长中文路径下，数据行高度明显为原标准行的两倍或可继续扩展；文本、状态、启动/编辑/删除图标垂直居中且可点击，滚动、双击、Enter、F5 和删除确认行为不变。
|
||
- 无障碍：启动、编辑、删除图标仍有不重叠的可见可用命中区；键盘焦点、选中行背景和长文本不依赖颜色或裁切传达信息。
|
||
|
||
## 执行记录
|
||
|
||
- 状态：DONE
|
||
- 变更：将行内图标的 30 dp 自然标准高度与 60 dp 数据行最小高度固化为命名常量；每条数据行以 60 dp 最小高度布局，现有文本、状态和操作区继续居中，内容可自然扩展。表头、列权重、行间距、虚拟列表、行/按钮命中优先级和键盘操作未改变。
|
||
- 验证：`go test ./internal/ui`、`go test ./...`、`go test -race ./internal/ui`、`go vet ./...`、`cmd /c build.bat` 均通过。
|
||
- 阻塞：无。
|