36 lines
2.8 KiB
Markdown
36 lines
2.8 KiB
Markdown
|
---
|
||
|
|
id: T-308
|
||
|
|
title: 设置页分区与控件边框层级
|
||
|
|
phase: 3
|
||
|
|
deps: [T-306]
|
||
|
|
status: DONE
|
||
|
|
created: 2026-07-26
|
||
|
|
owner: codex
|
||
|
|
---
|
||
|
|
|
||
|
|
## 需求与背景
|
||
|
|
|
||
|
|
设置页目前只有部分卡片和操作区具有边界，浏览器路径、目录、端口、代理和退出行为等组件在 Gio 实现中缺少清晰的视觉归属。需要在不改变现有保存、搜索、代理编辑或键盘交互的前提下，为设置模块整体及关键组件补充克制、一致的边框层级。
|
||
|
|
|
||
|
|
## 方案与边界
|
||
|
|
|
||
|
|
- 设置页采用三层层级：页面内容外层工作区、功能分区卡片、字段/状态/操作条。描边使用浅色 1dp、圆角与既有实例列表一致，不使用装饰性阴影。
|
||
|
|
- 浏览器路径、默认目录、运行行为和代理分别具有可识别的分区；路径、端口和代理地址的标签、说明、输入与关联操作保持在同一个字段边界内。代理删除仍使用既有确认流程。
|
||
|
|
- 底部“保存设置/取消”保持现有命令和顺序，仅以带上分隔线的操作区与表单内容分离。紧凑宽度下分区和字段按阅读顺序纵向排列，不裁剪按钮或文本。
|
||
|
|
- 仅调整设置页的视觉容器和间距；不修改实例页、创建/编辑实例表单、配置格式、浏览器启动、代理校验及异步搜索逻辑。
|
||
|
|
- 同步更新 `docs/ui/browser-manager.html`，作为设计交接基准；HTML 原型不代表 Gio 原生主题、DPI 或无障碍已完全验证。
|
||
|
|
|
||
|
|
## 验收要点
|
||
|
|
|
||
|
|
- 设置整体、浏览器路径、默认目录、运行行为、代理、路径字段、端口字段、状态提示和保存操作区均具有清晰且不过重的边框层级。
|
||
|
|
- 既有四个路径的选择/搜索/取消搜索、远程调试起始端口、退出时关闭托管浏览器、代理选择/保存/删除确认、保存/取消设置行为保持不变。
|
||
|
|
- 窄窗口按纵向重排，标签与帮助文本可读，按钮不被裁剪；Tab 顺序仍与视觉和阅读顺序一致。
|
||
|
|
- HTML 原型脚本可解析；`gofmt`、`go test ./...`、`go vet ./...`、`go build -o build/chub.exe ./cmd/chub` 和 Windows smoke 通过。
|
||
|
|
|
||
|
|
## 执行记录
|
||
|
|
|
||
|
|
- 状态：DONE
|
||
|
|
- 变更：设置内容改为持久 `widget.List` 承载的可滚动工作区；Gio 使用外层工作区、路径/目录/运行/代理分区卡片、字段容器、状态提示与操作条的浅色圆角 1dp 边框。路径字段在窄内容区会将编辑框与“选择/搜索”操作纵向重排，既有路径搜索、代理编辑和保存命令不变。HTML 原型同步了相同的工作区、卡片、字段、状态和操作区边框层级。
|
||
|
|
- 验证：`gofmt -w internal/ui/shell.go`、`go test ./internal/ui`、HTML 内嵌脚本语法检查、`scripts/smoke-windows.ps1`（含 `go test ./...`、`go vet ./...`、Windows 构建和 CLI JSON contract）均通过。
|
||
|
|
- 阻塞：无。
|