# 前端重设计 v2 —— 页面改造规范 本文件是改造**页面**时必须遵守的约定。基础设施(主题、布局、图标、样式)已经完成, 不需要你动。 ## 0. 铁律 1. **不动业务逻辑。** API 调用、轮询定时器、SSE 流式解析、上传与压缩、localStorage 键名、 错误分类、二次确认、权限判断 —— 全部保持与原文件**语义等价**。你只改模板结构与样式。 2. **不写硬编码颜色。** 不许出现 `#fff` / `#909399` / `#3b5998` / `rgba(0,0,0,.06)` 这类 具体色值(图表除外,图表用 `chartTheme()`)。一律用下面的 CSS 变量。 3. **不用 emoji 当图标。** 用 ``。 4. **不改 `src/locales/*.ts`。** 文案优先复用已有 key;确实缺 key 时,把 「key 路径 + 中文 + English」写进你的最终报告,由主流程统一补。 5. **完成后必须跑 `npm run typecheck`,要求 0 error。** ## 1. 主题 token(src/style.css 已定义,直接用) | 变量 | 用途 | | --- | --- | | `--bg` / `--bg-2` | 页面底色(bg 是内容区,bg-2 是最外层) | | `--surface` / `--surface-2` | 卡片底 / 次级底(输入框、只读控件) | | `--line` / `--line-2` | 分隔线(line 明显,line-2 极淡) | | `--text` / `--muted` / `--muted-2` | 主文字 / 次要 / 更淡 | | `--primary` / `--primary-ink` / `--primary-soft` | 主色 / 主色上的字 / 主色淡底 | | `--ok` `--warn` `--err` + `--ok-soft` `--warn-soft` `--err-soft` | 语义色与淡底 | | `--chip` | 灰色小底(标签、胶囊) | | `--radius` / `--radius-s` / `--radius-l` | 12 / 8 / 16 | | `--gap` | 14px 间距 | | `--chart-a` / `--chart-b` | 图表主/辅色(ECharts 用 `chartTheme()` 取) | 三套主题 A(深空蓝,深色)/ B(素白蓝紫,默认)/ C(暖砂墨绿)会自动切换这些变量, **页面不需要为某个主题写特例**。 ## 2. 页面外壳 ```vue
…
…
``` `.page` / `.page-fill` 自带 16/20 的内边距,窄屏自动收成 12/14。 `.page-fill` 内部需要自己安排「固定区 + 可滚区」。 **不要再使用** `.main-scroll`、`.page-card`(已删除)、`el-row` + `el-col` 栅格。 ## 3. 现成类(都在 src/style.css) - 卡片:`.card`(白底圆角边框)+ `.card-h`(内放 `标题` 和 `副标题` 以及右侧 `.pager`) - KPI:`.kpis`(4 列网格)> `.kpi` > `.k` / `.v` / `.f`;`.delta.up/.down/.flat`; 窄屏自动两列 - 栅格:`.grid2`(1.55fr 1fr)、`.grid3`(1.35fr 1fr)、`.grid-eq`(1fr 1fr),自带 `margin-top: var(--gap)` - 竖排信息行:`.pv` > `.pv-i` > `.nm` / `.st`;进度条 `.bar` > `i`(`width` 控制) - 状态胶囊:`.pill.ok/.warn/.err/.mute`;徽标 `.badge.g/.o/.r/.m` - 可选中的胶囊:`.chip-sel`(选中加 `.on`) - 表单:`.field`(`