9.9 KiB
浅色红色 UI 规范对齐 — 实施计划
依据:
H:\页面设计\UI设计规范\浅色红色设计规范-前端用.pdf(共 104 页) 范围:仅对齐 Light 模式(红色主题),不改动图表部分
⚠️ 重要约束(必读)
1. 主题切换必须保留
项目使用 next-themes 实现 Light/Dark 切换:
:root→ Light 模式(红色品牌,对应本规范).dark→ Dark 模式(蓝色品牌,不在本次范围内)- 切换组件入口:
src/components/theme-provider.tsx
所有改动只能动 :root 块和 light-only 选择器,禁止动 .dark 块和 dark: 前缀样式。
2. 不动图表
本次跳过 chart-1 ~ chart-5 颜色变量和所有图表组件。
3. 同一 token 双模式都用时如何改
若变量同时被 light/dark 使用(如 --radius、按钮 h-*、--primary-foreground),改动后需在 Dark 模式下回归检查,确保没有破坏。
改动总目标对照
| 类别 | UI 规范 | 现状 | 差异 |
|---|---|---|---|
| 主品牌红 | #F5222D |
#d92121 (oklch(0.52 0.19 27)) |
偏差 |
| 深色品牌 | #CF1322 / #A8071A |
未使用 | 缺失 |
| 圆角-按钮 | 2px | 12px (--radius: 0.75rem) |
严重偏大 |
| 圆角-卡片 | 4px | 12px | 严重偏大 |
| 按钮高度(正常) | 32px | 36px (h-9) |
偏大 4px |
| 按钮高度(小) | 24px | 32px (h-8) |
偏大 8px |
| 输入框高度 | 32px | 36px (h-9) |
偏大 4px |
| 中文字体 | NotoSansSChinese | 系统字体 | 未引入 |
| 数字字体 | D-DIN | 系统字体 | 未引入 |
| 间距体系 | 8px 基准(4/8/12/16/24/32/40/56) | Tailwind 默认 | 基本一致 |
分步实施计划
Step 1 — 颜色变量对齐(Light 模式)
文件:src/styles/globals.css
只动 :root 块(第 242-277 行),保持 .dark 块原样
1.1 主色映射
| 角色 | 规范值 | 用途 |
|---|---|---|
| 主色 | #F5222D |
--primary、--ring、--sidebar-primary |
| 主色 hover | #CF1322 |
按钮 hover 状态(新增辅助变量) |
| 主色 active | #A8071A |
按钮按下状态 |
| 主色淡 1 | #FEEDED |
--accent(极淡红,背景) |
| 主色淡 2 | #FDDADC |
hover bg、tag 背景 |
| 主色淡 3 | #FCB5B9 |
浅边框、selected 态 |
| 危险色 | #F5222D |
--destructive |
1.2 新增工程变量(建议加在 :root 内)
/* 红色主题阶梯色(规范色板)*/
--brand-50: #FEFAFA;
--brand-100: #FEF6F6;
--brand-200: #FEEDED;
--brand-300: #FDDADC;
--brand-400: #FCB5B9;
--brand-500: #FA9196;
--brand-600: #F86C73;
--brand-700: #F74750;
--brand-800: #F5222D; /* ← 主色 */
--brand-900: #CF1322; /* ← hover */
--brand-950: #A8071A; /* ← active */
/* 辅色(规范)*/
--accent-orange: #FF9900;
--accent-green: #2FD69A;
--accent-cyan: #45C3F3;
1.3 --workspace-brand 同步
:root 内:--workspace-brand: #F5222D;(从 #d92121 改)
.dark 内:不动(保持 #3b82f6 蓝色)
1.4 验收
- 切到 Light 模式:所有按钮、链接、选中态使用规范红
- 切到 Dark 模式:依然是原蓝色品牌(无变化)
Step 2 — 圆角规范化
文件:src/styles/globals.css(--radius 是全局变量,light/dark 共用)
2.1 改动方案(推荐)
按规范:按钮 2px、卡片/页面框 4px。但当前许多组件依赖 rounded-md / rounded-lg,全局把 --radius 改成 4px 会引起视觉跳变。
采用细粒度策略:
:root {
--radius: 0.25rem; /* 4px → 卡片/页面框 */
}
@theme inline {
--radius-sm: 2px; /* 按钮、tag */
--radius-md: calc(var(--radius) - 1px); /* 3px → 输入框 */
--radius-lg: var(--radius); /* 4px → 卡片 */
--radius-xl: calc(var(--radius) + 4px); /* 8px → 弹窗 */
--radius-2xl: calc(var(--radius) + 8px); /* 12px → 大卡片 */
}
2.2 例外保留(设计感样式)
以下组件圆角不改,保持设计稿原貌:
.workspace-user-bubble(聊天气泡,圆角1.6rem 1.6rem 0.5rem 1.6rem).workspace-assistant-card(圆角1.75rem).gemini-gradient-border(圆角1.5rem)
2.3 验收
- 普通按钮变为近直角(2px)
- 卡片维持温和圆角(4px)
- 聊天气泡、AI 卡片不变形
Step 3 — 按钮组件尺寸对齐
文件:src/components/ui/button.tsx
3.1 改 size 变体(规范:小 24px / 正常 32px)
| size | 规范 | 当前 | 改后 |
|---|---|---|---|
sm |
24px | h-8 (32px) | h-6 px-2 text-xs |
default |
32px | h-9 (36px) | h-8 px-3 text-sm |
lg |
— | h-10 (40px) | 保留 h-10(用于 Banner/登录场景) |
3.2 圆角
- 默认按钮:
rounded-sm(2px)
3.3 主按钮配色
- bg:
bg-primary - hover:
hover:bg-[var(--brand-900)](深红#CF1322) - active:
active:bg-[var(--brand-950)](更深#A8071A) - disabled:
disabled:opacity-50(保留)
3.4 次要按钮 / 文本按钮
- 次要按钮(
outlinevariant):边框border-primary,文字text-primary - 文本按钮(
ghostvariant):仅文字色text-primary,hover 背景--brand-200
3.5 验收
检查所有调用 <Button> 的页面:
- 工具栏按钮(之前 h-9 → 现在 h-8)
- 弹窗确认/取消(之前 h-9 → 现在 h-8)
- Landing 主 CTA 按钮(保留
lg)
Step 4 — 输入框尺寸对齐
4.1 src/components/ui/input.tsx
h-9→h-8(32px)rounded-md(沿用 3px)- 边框:
border-input(变量已是浅灰,不变) - focus:
focus-visible:ring-[2px] focus-visible:ring-primary/35
4.2 src/components/ui/textarea.tsx
- 最小高度建议
min-h-16 - 圆角
rounded-md
4.3 src/components/ui/select.tsx
size: default→h-8size: sm→h-6
4.4 验收
- 搜索框、表单输入、下拉框高度一致(32px)
- 与按钮对齐时高度一致
Step 5 — 字体引入
5.1 引入字体文件
在 frontend-web/public/fonts/ 下放置:
NotoSansSC-Regular.woff2/Medium.woff2/Bold.woff2D-DIN-Regular.woff2/Bold.woff2
若需在线方式,可用 Google Fonts CDN:
https://fonts.googleapis.com/css2?family=Noto+Sans+SC:wght@300;400;500;600;700&display=swap
5.2 globals.css 顶部添加 @font-face
@font-face {
font-family: 'Noto Sans SC';
src: url('/fonts/NotoSansSC-Regular.woff2') format('woff2');
font-weight: 400;
font-display: swap;
}
/* Medium / Bold 同上 */
@font-face {
font-family: 'D-DIN';
src: url('/fonts/D-DIN-Regular.woff2') format('woff2');
font-weight: 400;
font-display: swap;
}
5.3 修改 --font-sans(globals.css 第 74 行)
--font-sans:
'Noto Sans SC', ui-sans-serif, system-ui, sans-serif,
'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
--font-numeric: 'D-DIN', 'Noto Sans SC', sans-serif;
5.4 数字字体工具类
新增 .font-numeric { font-family: var(--font-numeric); font-variant-numeric: tabular-nums; }
仪表盘、表格中重要数字加 className="font-numeric"。
5.5 验收
- 中文文本回退到 Noto Sans SC
- Dark 模式同样生效(字体是全局变量)
Step 6 — Badge / 状态标签色对齐
文件:src/components/ui/badge.tsx
规范状态色(参考 PDF 第 67 页):
| 状态 | 颜色定位 | 推荐 token |
|---|---|---|
| 未开始 | 中性灰 | bg-muted text-muted-foreground |
| 等待中 | 蓝/青 | bg-blue-50 text-blue-600(保留) |
| 进行中 | 主红 | bg-[var(--brand-200)] text-primary |
| 已完成 | 绿 | bg-emerald-50 text-emerald-600 |
| 已失败 | 红/橙 | bg-red-50 text-red-600 |
| 待更新 | 黄/橙 | bg-amber-50 text-amber-700 |
需要新增 variant:waiting、processing、success、failed、pending。
圆角统一 rounded-sm,padding px-2 py-0.5,字号 text-xs。
Step 7 — 全局间距 & 阴影规范化
7.1 间距
规范基于 8px 网格(4 / 8 / 12 / 16 / 24 / 32 / 40 / 56)。Tailwind 默认 4px 步进(p-1=4, p-2=8...)已兼容。
只需 review:检查页面是否有 p-2.5、gap-1.5 等非 8 的倍数,统一改成 8 的倍数。
7.2 阴影
规范阴影仅用于"标题+操作"和"卡片新增"两类。其余卡片保持平。
新增工具类(可选):
.shadow-card { box-shadow: 0 2px 8px 0 rgba(0,0,0,0.06); }
.shadow-card-hover { box-shadow: 0 4px 12px 0 rgba(0,0,0,0.08); }
Step 8 — 验收清单
每步完成后检查:
- Light 模式视觉对齐规范(参考 PDF 关键页:5、7、10、36、66)
- Dark 模式完全无变化(切换主题验证)
- 首页 / Workspace / 聊天 / 设置弹窗 → 按钮和输入框高度统一
- 主题切换按钮点击 → 颜色平滑切换,无错位/闪烁
/landing强制 Dark 模式仍正常- 控制台无 CSS 变量未定义警告
执行顺序建议
Step 1 (颜色变量) ─┐
├→ Step 3 (按钮) ─┐
Step 2 (圆角) ─┘ ├→ Step 6 (Badge) ─→ Step 7 (间距/阴影) ─→ Step 8 (验收)
│
Step 4 (输入框) ──┤
Step 5 (字体) ────┘
并行可行:Step 1 + Step 2 完成后,Step 3/4/5 可同时推进。
风险提示
- 圆角从 12px → 4px 是大幅度视觉变化,建议先在分支上做、配截图比对再合并
- 字体文件体积较大(NotoSansSC 全字符集 ~10MB),建议子集化或仅引入需要的字重
--radius-sm改后可能影响 dropdown menu / popover 等小组件外观,需逐个检查- Dark 模式下的红色
--workspace-brand已是蓝色,不要把蓝色也改成 #F5222D