feat: 设计系统迁移至 Microsoft Fluent 2 / Windows 11 风格
Deploy Wiki to Production / deploy (push) Has been cancelled
Deploy Wiki to Production / deploy (push) Has been cancelled
- 品牌色 #1677FF → #0078D4 (Fluent Communication Blue) - 中性色升级为 11 级 Fluent 2 阶梯 + 8 级 alpha 透明色 - 新增材质效果 (Acrylic/Mica/Smoke)、动效缓动、完整 Type Ramp - 阴影升级为 6 级 Elevation 体系 (shadow2-64 + z-index 映射) - index.html 全面重设计:亚克力顶栏、Fluent 卡片、Tab 风格 Chip - 响应式断点改为 Fluent 2 标准 (639/1023/1024px) - 字体优先 Segoe UI Variable,行高 1.4285 (20px) - design-tokens.md 新增向后兼容矩阵与非标准文件清单
This commit is contained in:
+481
-124
@@ -1,155 +1,446 @@
|
||||
# UI 设计规范 — Ant Design 阿里云风格
|
||||
# UI 设计规范 — Microsoft Fluent 2 / Windows 11
|
||||
|
||||
> 本项目的报告页面、索引页面均遵循此规范。
|
||||
> 设计灵感来源于 Ant Design v5 + 阿里云控制台主题。
|
||||
> 本项目设计系统已从 Ant Design v5(阿里云风格)迁移至 **Microsoft Fluent 2**(Windows 11 风格)。
|
||||
> 旧 Token 名保留不变(向后兼容),新 Token 使用 `--fluent-*` 前缀。
|
||||
|
||||
---
|
||||
|
||||
## 1. 配色方案
|
||||
## 0. 变更日志
|
||||
|
||||
### 1.1 品牌色
|
||||
| 日期 | 版本 | 变更 |
|
||||
|------|------|------|
|
||||
| 2026-06-05 | 2.0 | 主设计系统从 Ant Design v5 迁移至 Fluent 2;品牌色 `#1677FF`→`#0078D4`;新增材质/动效/完整色彩阶梯/字体体系;`index.html` 同步重设计 |
|
||||
| ~2026-05 | 1.0 | 初始版本,基于 Ant Design v5 + 阿里云控制台风格 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 品牌色
|
||||
|
||||
### 1.1 核心品牌色
|
||||
|
||||
| 用途 | Token | 值 | 说明 |
|
||||
|------|-------|------|------|
|
||||
| 品牌主色 | `--color-primary` | `#1677FF` | Ant Design v5 默认品牌蓝 |
|
||||
| 悬停态 | `--color-primary-hover` | `#4096FF` | 主色上浮一级 |
|
||||
| 激活态 | `--color-primary-active` | `#0958D9` | 主色下压一级 |
|
||||
| 浅色背景 | `--color-primary-bg` | `#E6F4FF` | 品牌蓝 6% 不透明度 |
|
||||
| 品牌主色 | `--color-primary` | `#0078D4` | Fluent 2 Communication Blue |
|
||||
| 悬停态 | `--color-primary-hover` | `#106EBE` | shade-10 |
|
||||
| 激活态 | `--color-primary-active` | `#005A9E` | shade-20 |
|
||||
| 浅色背景 | `--color-primary-bg` | `#DEECF9` | tint-30 |
|
||||
|
||||
### 1.2 功能色
|
||||
### 1.2 Fluent 2 Tint/Shade 链(新增)
|
||||
|
||||
| 用途 | Token | 值 |
|
||||
|------|-------|------|
|
||||
| 成功 | `--color-success` | `#52C41A` |
|
||||
| 警告 | `--color-warning` | `#FAAD14` |
|
||||
| 错误 | `--color-error` | `#FF4D4F` |
|
||||
| 信息 | `--color-info` | `#1677FF` |
|
||||
```
|
||||
tint-40: #EFF6FC 最浅(微妙填充)
|
||||
tint-30: #DEECF9 浅背景 = --color-primary-bg
|
||||
tint-20: #C7E0F4 hover 填充 / focus ring
|
||||
tint-10: #2B88D8 悬停轮廓 / 强调边框
|
||||
primary: #0078D4 品牌主色 = --color-primary
|
||||
shade-10: #106EBE 悬停态 = --color-primary-hover
|
||||
shade-20: #005A9E 激活态 = --color-primary-active
|
||||
shade-30: #004578 最深(高亮文字 / 深色背景)
|
||||
```
|
||||
|
||||
### 1.3 中性色(亮色主题 / 报告页用暗色主题变体)
|
||||
对应 CSS Token:
|
||||
|
||||
| 用途 | Token | 亮色值 | 暗色值 |
|
||||
|------|-------|--------|--------|
|
||||
| 页面背景 | `--bg` | `#F5F5F5` | `#0B0F1A` |
|
||||
| 容器背景 | `--bg-container` | `#FFFFFF` | `#111827` |
|
||||
| 二级背景 | `--bg-elevated` | `#FAFAFA` | `#1A2235` |
|
||||
| 边框 | `--border` | `#D9D9D9` | `#1E2A3A` |
|
||||
| 边框浅 | `--border-light` | `#F0F0F0` | `#151D2E` |
|
||||
| 主文字 | `--text-primary` | `#141414` | `#E8ECF1` |
|
||||
| 次要文字 | `--text-secondary` | `#595959` | `#8892A4` |
|
||||
| 辅助文字 | `--text-tertiary` | `#8C8C8C` | `#5A6478` |
|
||||
|
||||
### 1.4 渐变色
|
||||
|
||||
| 用途 | 值 |
|
||||
|------|------|
|
||||
| 标题渐变 | `linear-gradient(135deg, #1677FF 0%, #722ED1 100%)` |
|
||||
| 成功渐变 | `linear-gradient(135deg, #52C41A 0%, #1677FF 100%)` |
|
||||
| Token | 值 |
|
||||
|-------|-----|
|
||||
| `--fluent-primary-tint-40` | `#EFF6FC` |
|
||||
| `--fluent-primary-tint-30` | `#DEECF9` |
|
||||
| `--fluent-primary-tint-20` | `#C7E0F4` |
|
||||
| `--fluent-primary-tint-10` | `#2B88D8` |
|
||||
| `--fluent-primary-shade-10` | `#106EBE` |
|
||||
| `--fluent-primary-shade-20` | `#005A9E` |
|
||||
| `--fluent-primary-shade-30` | `#004578` |
|
||||
|
||||
---
|
||||
|
||||
## 2. 字体规范
|
||||
## 2. 功能色
|
||||
|
||||
基于 Ant Design 动态秩序原则,基准字号 **14px**,行高 **22px**。
|
||||
| 用途 | Token | 值 | Fluent 语义 |
|
||||
|------|-------|------|------------|
|
||||
| 成功 | `--color-success` | `#107C10` | Green (深绿,更专业) |
|
||||
| 警告 | `--color-warning` | `#FF8C00` | Orange (取代琥珀色) |
|
||||
| 错误 | `--color-error` | `#FF4D4F` | Red (保留 Ant Design 红,对比度更优) |
|
||||
|
||||
| 级别 | 字号 | 行高 | 字重 | 场景 |
|
||||
### 2.1 功能色浅色背景(新增)
|
||||
|
||||
| Token | 值 | 说明 |
|
||||
|-------|-----|------|
|
||||
| `--fluent-success-bg` | `#DFF6DD` | 成功态浅色背景 |
|
||||
| `--fluent-warning-bg` | `#FFF4CE` | 警告态浅色背景 |
|
||||
| `--fluent-error-bg` | `#FDE7E9` | 错误态浅色背景 |
|
||||
| `--fluent-success-border` | `#A7E3A1` | 成功态边框 |
|
||||
| `--fluent-warning-border` | `#FFD335` | 警告态边框 |
|
||||
| `--fluent-error-border` | `#EEACB2` | 错误态边框 |
|
||||
|
||||
### 2.2 废弃 Token
|
||||
|
||||
| Token | 状态 | 说明 |
|
||||
|-------|------|------|
|
||||
| `--color-info` | **已移除** | 0 个文件使用,死 Token |
|
||||
|
||||
---
|
||||
|
||||
## 3. 中性色
|
||||
|
||||
### 3.1 Fluent 2 完整中性阶梯
|
||||
|
||||
```css
|
||||
--fluent-neutral-0: #FFFFFF; 纯白(页面/卡片背景)
|
||||
--fluent-neutral-2: #F8F8F8; 微妙灰
|
||||
--fluent-neutral-4: #F4F4F4;
|
||||
--fluent-neutral-6: #F2F2F2;
|
||||
--fluent-neutral-8: #EBEBEB;
|
||||
--fluent-neutral-10: #E1DFDD; 边框色
|
||||
--fluent-neutral-20: #C8C8C8;
|
||||
--fluent-neutral-30: #A6A6A6; 占位文字 / disabled
|
||||
--fluent-neutral-60: #666666; 次要文字
|
||||
--fluent-neutral-70: #3C3C3C;
|
||||
--fluent-neutral-80: #201F1E; 主文字
|
||||
```
|
||||
|
||||
### 3.2 旧 Token → 新值映射(亮色)
|
||||
|
||||
| Token | 旧值 (AntD) | 新值 (Fluent 2) | 对应 Fluent Token |
|
||||
|-------|------------|----------------|-------------------|
|
||||
| `--bg` | `#F5F5F5` | `#FAF9F8` | neutral-2 |
|
||||
| `--bg-container` | `#FFFFFF` | `#FFFFFF` | neutral-0 |
|
||||
| `--bg-elevated` | `#FAFAFA` | `#F3F2F1` | neutral-4 |
|
||||
| `--border` | `#D9D9D9` | `#E1DFDD` | neutral-10 |
|
||||
| `--border-light` | `#F0F0F0` | `#EDEBE9` | neutral-8 |
|
||||
| `--text-primary` | `#141414` | `#201F1E` | neutral-80 |
|
||||
| `--text-secondary` | `#595959` | `#605E5C` | neutral-70 |
|
||||
| `--text-tertiary` | `#8C8C8C` | `#8A8886` | neutral-60 |
|
||||
|
||||
### 3.3 暗色主题(`[data-theme="dark"]`)
|
||||
|
||||
| Token | 旧值 (AntD) | 新值 (Fluent 2 Dark) |
|
||||
|-------|------------|---------------------|
|
||||
| `--bg` | `#0B0F1A` / `#111111` | `#1F1F1F` |
|
||||
| `--bg-container` | `#111827` / `#1C1C1E` | `#292929` |
|
||||
| `--bg-elevated` | `#1A2235` / `#242426` | `#333333` |
|
||||
| `--border` | `#1E2A3A` / `#3A3A3C` | `#474747` |
|
||||
| `--border-light` | `#151D2E` / `#2C2C2E` | `#3D3D3D` |
|
||||
| `--text-primary` | `#E8ECF1` / `#D1D1D6` | `#DADADA` |
|
||||
| `--text-secondary` | `#8892A4` / `#8E8E93` | `#A0A0A0` |
|
||||
| `--text-tertiary` | `#5A6478` / `#636366` | `#7A7A7A` |
|
||||
|
||||
暗色品牌色:
|
||||
|
||||
| Token | 值 |
|
||||
|-------|-----|
|
||||
| `--color-primary` (dark) | `#479EF5` |
|
||||
| `--color-primary-bg` (dark) | `rgba(71,158,245,0.15)` |
|
||||
|
||||
### 3.4 透明中性色(Fluent Alpha 系列,新增)
|
||||
|
||||
```css
|
||||
--fluent-alpha-2: rgba(0,0,0,0.02);
|
||||
--fluent-alpha-4: rgba(0,0,0,0.04);
|
||||
--fluent-alpha-8: rgba(0,0,0,0.08);
|
||||
--fluent-alpha-10: rgba(0,0,0,0.10);
|
||||
--fluent-alpha-20: rgba(0,0,0,0.20);
|
||||
--fluent-alpha-30: rgba(0,0,0,0.30);
|
||||
--fluent-alpha-40: rgba(0,0,0,0.40);
|
||||
--fluent-alpha-80: rgba(0,0,0,0.80);
|
||||
```
|
||||
|
||||
暗色对应 `rgba(255, 255, 255, ...)`。
|
||||
|
||||
---
|
||||
|
||||
## 4. 字体规范
|
||||
|
||||
### 4.1 字体族
|
||||
|
||||
```css
|
||||
/* 正文(优先 Windows 11 可变字体) */
|
||||
--fluent-font-family-text: 'Segoe UI Variable Text', 'Segoe UI', system-ui,
|
||||
-apple-system, BlinkMacSystemFont, 'PingFang SC', 'Hiragino Sans GB',
|
||||
'Microsoft YaHei', 'Helvetica Neue', Arial, sans-serif;
|
||||
|
||||
/* 标题 / 大字号展示 */
|
||||
--fluent-font-family-display: 'Segoe UI Variable Display', 'Segoe UI',
|
||||
system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
|
||||
|
||||
/* 等宽代码 */
|
||||
--fluent-font-family-monospace: 'Cascadia Code', 'Fira Code', 'SF Mono',
|
||||
'Menlo', 'Monaco', 'Courier New', monospace;
|
||||
|
||||
/* 旧版兼容(无 Segoe UI Variable 的旧系统自动回退) */
|
||||
--font-family: var(--fluent-font-family-text);
|
||||
```
|
||||
|
||||
### 4.2 字号阶梯(Fluent 2 Type Ramp)
|
||||
|
||||
| 级别 | 字号 | 行高 | 字重 | 用途 |
|
||||
|------|------|------|------|------|
|
||||
| H1 页面标题 | 30px | 38px | 700 | 报告页眉标题 |
|
||||
| H2 区块标题 | 24px | 32px | 600 | 报告 section 标题 |
|
||||
| H3 小节标题 | 20px | 28px | 600 | 子章节标题 |
|
||||
| H4 小标题 | 16px | 24px | 600 | 卡片内标题 |
|
||||
| Body 正文 | 14px | 22px | 400 | 正文内容 |
|
||||
| Caption 辅助 | 12px | 20px | 400 | 标签、注释、日期 |
|
||||
| Caption 2 | 10px | 14px | 400 | 极小辅助文字 |
|
||||
| Caption 1 | 12px | 16px | 400 | 辅助文字 / Tag / 日期 |
|
||||
| **Body 1** | **14px** | **20px** | **400** | **正文(基准)** |
|
||||
| Body 1 Strong | 14px | 20px | 600 | 强调正文 |
|
||||
| Subtitle 2 | 16px | 22px | 600 | 卡片标题 |
|
||||
| Subtitle 1 | 20px | 26/28px | 600 | 小节标题 |
|
||||
| Title 3 | 24px | 32px | 600 | 区域标题 |
|
||||
| Title 2 | 28px | 36px | 600 | 页面标题 |
|
||||
| Title 1 | 32px | 40px | 600 | 大标题 |
|
||||
| Large Title | 40px | 52px | 600 | Hero 标题 |
|
||||
| Display | 68px | 92px | 600 | 超大展示 |
|
||||
|
||||
### 字体族
|
||||
**与旧版(Ant Design)差异**:
|
||||
- 正文行高 `22px → 20px`(更紧凑,Fluent 标准)
|
||||
- 同一字号提供 Regular/Semibold/Bold 字重变体
|
||||
- 新增 Display (68px) 和 Large Title (40px) 级别
|
||||
|
||||
---
|
||||
|
||||
## 5. 圆角规范
|
||||
|
||||
### 5.1 旧 Token → 新值
|
||||
|
||||
| Token | 旧值 | 新值 (Fluent 2) | 使用场景 |
|
||||
|-------|------|----------------|---------|
|
||||
| `--radius-xs` | 2px | 2px | Tag、极小 Badge |
|
||||
| `--radius-sm` | 6px | **4px** | 按钮、输入框(Fluent 基准) |
|
||||
| `--radius-md` | 8px | **6px** | 卡片、面板 |
|
||||
| `--radius-lg` | 12px | **8px** | 弹窗、大容器 |
|
||||
|
||||
### 5.2 新增 Fluent 命名 Token
|
||||
|
||||
| Token | 值 | 说明 |
|
||||
|-------|-----|------|
|
||||
| `--fluent-radius-none` | 0px | 无线条 |
|
||||
| `--fluent-radius-small` | 2px | = `--radius-xs` |
|
||||
| `--fluent-radius-medium` | 4px | = `--radius-sm` |
|
||||
| `--fluent-radius-large` | 6px | = `--radius-md` |
|
||||
| `--fluent-radius-xlarge` | 8px | = `--radius-lg` |
|
||||
| `--fluent-radius-circular` | 9999px | 胶囊形 / 圆形 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 间距规范
|
||||
|
||||
### 6.1 旧版(保留,标记 Legacy)
|
||||
|
||||
基于 8px 基准,仅 3 个文件使用:
|
||||
|
||||
| Token | 值 | 状态 |
|
||||
|-------|-----|------|
|
||||
| `--space-xs` | 4px | Legacy — 已使用 |
|
||||
| `--space-sm` | 8px | Legacy — 已使用 |
|
||||
| `--space-md` | 12px | Legacy — 已使用 |
|
||||
| `--space-lg` | 16px | Legacy — 已使用 |
|
||||
| `--space-xl` | 24px | Legacy — 已使用 |
|
||||
| `--space-2xl` | 32px | Legacy — 已使用 |
|
||||
| `--space-3xl` | 48px | Legacy — 已使用 |
|
||||
|
||||
### 6.2 Fluent 2 间距阶梯(推荐新工作使用)
|
||||
|
||||
基于 4px 基准,17 级:
|
||||
|
||||
| Token | 值 | 使用场景 |
|
||||
|-------|-----|---------|
|
||||
| `--fluent-spacing-2xs` | 2px | 图标对齐微调 |
|
||||
| `--fluent-spacing-xs` | 4px | 极紧凑 |
|
||||
| `--fluent-spacing-sm` | 8px | 小间距 |
|
||||
| `--fluent-spacing-md` | 12px | 中等间距 |
|
||||
| `--fluent-spacing-lg` | 16px | 标准间距 |
|
||||
| `--fluent-spacing-xl` | 20px | 紧凑段落 |
|
||||
| `--fluent-spacing-2xl` | 24px | 大间距 |
|
||||
| `--fluent-spacing-3xl` | 28px | 区块间距 |
|
||||
| `--fluent-spacing-4xl` | 32px | — |
|
||||
| `--fluent-spacing-5xl` | 40px | — |
|
||||
| `--fluent-spacing-6xl` | 48px | 大区块间距 |
|
||||
| `--fluent-spacing-7xl` | 56px | 最大间距 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 阴影与层级
|
||||
|
||||
### 7.1 旧 Token → 新值
|
||||
|
||||
| Token | 新值 (Fluent 2) |
|
||||
|-------|----------------|
|
||||
| `--shadow-sm` | `0 0 2px rgba(0,0,0,0.12), 0 1px 2px rgba(0,0,0,0.14)` |
|
||||
| `--shadow-md` | `0 0 2px rgba(0,0,0,0.12), 0 2px 4px rgba(0,0,0,0.14)` |
|
||||
| `--shadow-lg` | `0 0 2px rgba(0,0,0,0.12), 0 4px 8px rgba(0,0,0,0.14)` |
|
||||
|
||||
### 7.2 Fluent 2 完整 Elevation 体系(新增)
|
||||
|
||||
| Token | z-index 层级 | 使用场景 |
|
||||
|-------|-------------|---------|
|
||||
| `--fluent-shadow-2` | 100 | 卡片静止态 |
|
||||
| `--fluent-shadow-4` | 200 | 卡片悬停 / Tooltip |
|
||||
| `--fluent-shadow-8` | 300 | 下拉菜单 / Flyout |
|
||||
| `--fluent-shadow-16` | 400 | 对话框 / Modal |
|
||||
| `--fluent-shadow-28` | 500 | 抽屉侧栏 / 教学气泡 |
|
||||
| `--fluent-shadow-64` | 600 | 通知 / Toast |
|
||||
|
||||
### 7.3 z-index 层级表
|
||||
|
||||
| 层级 | z-index | 元素 |
|
||||
|------|---------|------|
|
||||
| Base | 0 | 正文内容 |
|
||||
| Sticky | 90 | Chip 筛选栏 |
|
||||
| Header | 100 | 顶栏 / 卡片静止 |
|
||||
| Overlay | 200 | 遮罩层 / Tooltip |
|
||||
| Flyout | 300 | 下拉菜单 |
|
||||
| Modal | 400 | 模态弹窗 |
|
||||
| Drawer | 500 | 抽屉 |
|
||||
| Toast | 600 | 通知 |
|
||||
|
||||
---
|
||||
|
||||
## 8. 材质效果(Fluent 2 独有,新增)
|
||||
|
||||
### 8.1 Acrylic(亚克力)
|
||||
|
||||
半透明模糊材质,用于导航栏、侧栏面板:
|
||||
|
||||
```css
|
||||
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
|
||||
'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei',
|
||||
'Helvetica Neue', Helvetica, Arial, sans-serif;
|
||||
--fluent-acrylic-default: rgba(255, 255, 255, 0.7);
|
||||
--fluent-acrylic-dark: rgba(47, 47, 47, 0.85);
|
||||
--fluent-backdrop-blur: 40px;
|
||||
|
||||
/* 使用示例 */
|
||||
.header {
|
||||
background: var(--fluent-acrylic-default);
|
||||
backdrop-filter: blur(var(--fluent-backdrop-blur)) saturate(125%);
|
||||
border-bottom: 0.5px solid var(--fluent-alpha-4);
|
||||
}
|
||||
```
|
||||
|
||||
代码字体:
|
||||
### 8.2 Mica(云母)
|
||||
|
||||
采样桌面壁纸色调的微弱材质,用于标题栏背景:
|
||||
|
||||
```css
|
||||
font-family: 'SF Mono', 'Menlo', 'Monaco', 'Courier New', monospace;
|
||||
--fluent-mica-bg: rgba(243, 242, 241, 0.7);
|
||||
--fluent-mica-bg-dark: rgba(32, 31, 30, 0.7);
|
||||
|
||||
/* 使用示例 */
|
||||
.title-bar {
|
||||
background: var(--fluent-mica-bg);
|
||||
backdrop-filter: blur(8px);
|
||||
}
|
||||
```
|
||||
|
||||
### 8.3 Smoke(烟雾遮罩)
|
||||
|
||||
用于 Modal / Flyout 背后的遮罩层:
|
||||
|
||||
```css
|
||||
--fluent-smoke-default: rgba(0, 0, 0, 0.4);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 圆角规范
|
||||
## 9. 动效与缓动(新增)
|
||||
|
||||
Ant Design v5 四级圆角体系:
|
||||
### 9.1 缓动曲线
|
||||
|
||||
| Token | 值 | 使用场景 |
|
||||
|-------|------|---------|
|
||||
| `radius-xs` | 2px | Tag、Badge |
|
||||
| `radius-sm` | 6px | Input、Button、小卡片 |
|
||||
| `radius-md` | 8px | Card、Panel、大卡片 |
|
||||
| `radius-lg` | 12px | Modal、弹窗、大容器 |
|
||||
```css
|
||||
--fluent-easing-accelerate: cubic-bezier(0.9, 0.1, 1.0, 0.2); /* 元素离开 */
|
||||
--fluent-easing-decelerate: cubic-bezier(0.1, 0.9, 0.2, 1.0); /* 元素进入 */
|
||||
--fluent-easing-standard: cubic-bezier(0.8, 0.0, 0.2, 1.0); /* 通用状态变化 */
|
||||
```
|
||||
|
||||
### 9.2 时长
|
||||
|
||||
```css
|
||||
--fluent-duration-faster: 83ms; /* 微交互(ripple、hover 开始) */
|
||||
--fluent-duration-fast: 100ms; /* hover 进出 */
|
||||
--fluent-duration-normal: 167ms; /* 标准过渡 */
|
||||
--fluent-duration-slow: 250ms; /* 面板展开/关闭 */
|
||||
--fluent-duration-slower: 333ms; /* 页面过渡 */
|
||||
```
|
||||
|
||||
### 9.3 过渡速查
|
||||
|
||||
| 场景 | 属性 | 时长 | 缓动 |
|
||||
|------|------|------|------|
|
||||
| 链接颜色 | color | 100ms | standard |
|
||||
| 卡片悬停 | box-shadow | 167ms | standard |
|
||||
| 按钮 hover | background | 100ms | decelerate |
|
||||
| 面板展开 | max-height | 250ms | standard |
|
||||
| 抽屉进出 | transform | 250ms | standard |
|
||||
| 遮罩淡入 | opacity | 167ms | decelerate |
|
||||
|
||||
---
|
||||
|
||||
## 4. 间距规范
|
||||
|
||||
基于 **8px** 基准单位:
|
||||
|
||||
| Token | 值 | 使用场景 |
|
||||
|-------|------|---------|
|
||||
| `space-xs` | 4px | 极紧凑间距 |
|
||||
| `space-sm` | 8px | 小间距 |
|
||||
| `space-md` | 12px | 中等间距 |
|
||||
| `space-lg` | 16px | 标准间距 |
|
||||
| `space-xl` | 24px | 大间距 |
|
||||
| `space-2xl` | 32px | 区块间距 |
|
||||
| `space-3xl` | 48px | 大区块间距 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 布局规范
|
||||
## 10. 布局规范
|
||||
|
||||
| 元素 | 值 | 说明 |
|
||||
|------|------|------|
|
||||
| 顶栏高度 | `64px` | Ant Design 标准顶栏 |
|
||||
| 侧栏宽度 | `260px` | 目录导航栏 |
|
||||
| 内容区最大宽度 | `1200px` | 居中显示 |
|
||||
| 内容区内边距 | `32px 40px` | 桌面端 |
|
||||
| 移动端内边距 | `16px` | ≤768px |
|
||||
| 顶栏高度 (`--header-h`) | `64px` | Fluent / Ant Design 通用 |
|
||||
| 侧栏宽度 (`--sidebar-w`) | `260px` | 桌面端导航 |
|
||||
| 内容区最大宽度 | `1200px` | 标准内容区 |
|
||||
| 宽版内容区 | `1600px` | 大屏仪表盘 / Landing |
|
||||
| 侧边距 | `5%` | 流式响应(Fluent 风格) |
|
||||
| 移动端内边距 | `16px` | ≤639px |
|
||||
|
||||
---
|
||||
|
||||
## 6. 阴影规范
|
||||
## 11. 响应式断点
|
||||
|
||||
| Token | 值 | 使用场景 |
|
||||
|-------|------|---------|
|
||||
| `shadow-sm` | `0 1px 2px rgba(0,0,0,0.03), 0 1px 6px -1px rgba(0,0,0,0.02)` | 小卡片 |
|
||||
| `shadow-md` | `0 2px 4px rgba(0,0,0,0.04), 0 4px 12px -2px rgba(0,0,0,0.04)` | 卡片悬停 |
|
||||
| `shadow-lg` | `0 4px 8px rgba(0,0,0,0.06), 0 8px 24px -4px rgba(0,0,0,0.08)` | 弹窗、下拉 |
|
||||
Fluent 2 使用自有断点体系(取代 Ant Design 断点):
|
||||
|
||||
暗色主题变体将 rgba 的 alpha 值减半。
|
||||
| 断点 | 值 | 说明 |
|
||||
|------|------|------|
|
||||
| sm | 480px | 小手机横屏 |
|
||||
| md | 640px | 平板竖屏(侧栏隐藏) |
|
||||
| lg | 1024px | 平板横屏(紧凑侧栏) |
|
||||
| xl | 1366px | 桌面完整布局 |
|
||||
| xxl | 1920px | 大屏 |
|
||||
|
||||
**本项目使用**:
|
||||
- `≤639px`:移动端 — 隐藏侧栏,显示 Chip 筛选 + 抽屉导航
|
||||
- `640px–1023px`:平板 — 紧凑侧栏(220px)
|
||||
- `≥1024px`:桌面 — 完整布局(260px 侧栏)
|
||||
|
||||
---
|
||||
|
||||
## 7. 组件规范
|
||||
## 12. 组件规范
|
||||
|
||||
### 7.1 卡片 Card
|
||||
### 12.1 卡片 Card(Fluent 2 风格)
|
||||
|
||||
- 背景:`--bg-container`
|
||||
- 边框:`1px solid --border`
|
||||
- 圆角:`8px`
|
||||
- 内边距:`24px`
|
||||
- 悬停:边框色变为 `--color-primary`,添加 `shadow-md`
|
||||
- 过渡:`all 0.2s ease`
|
||||
- 圆角:`6px`(`--radius-md`)
|
||||
- 内边距:`20px`
|
||||
- 静止态:`box-shadow: var(--fluent-shadow-2)`(极淡阴影)
|
||||
- 悬停态:`box-shadow: var(--fluent-shadow-4)`(上浮一层),边框色不变
|
||||
- 过渡:`box-shadow var(--fluent-duration-normal) var(--fluent-easing-standard)`
|
||||
- **移除**:旧版 `border-color` 变色 + `transform: scale(0.99)` 点击缩放
|
||||
|
||||
### 7.2 标签 Badge
|
||||
### 12.2 标签 Badge
|
||||
|
||||
- 内边距:`2px 10px`
|
||||
- 圆角:`12px`(胶囊形)
|
||||
- 圆角:`2px`(`--radius-xs`,Fluent 直角风格) 或 `12px`(胶囊形,按场景选择)
|
||||
- 字号:`12px`
|
||||
- 字重:`600`
|
||||
- 背景:对应功能色的 10% 不透明度
|
||||
- 边框:`1px solid` 对应功能色的 25% 不透明度
|
||||
- 背景:`--fluent-primary-tint-30`
|
||||
- 文字色:`--color-primary`
|
||||
|
||||
### 7.3 表格 Table
|
||||
### 12.3 按钮 Button
|
||||
|
||||
- 主按钮背景:`--color-primary`
|
||||
- 主按钮文字:`#FFFFFF`
|
||||
- 次要按钮背景:`transparent`
|
||||
- 次要按钮边框:`1px solid --border`
|
||||
- 圆角:`4px`(`--fluent-radius-medium`)
|
||||
- 最小高度:`32px`
|
||||
- hover:背景色上浮至 `shade-10` / `tint-30`
|
||||
- 过渡:`background var(--fluent-duration-fast) var(--fluent-easing-decelerate)`
|
||||
|
||||
### 12.4 输入框 Input
|
||||
|
||||
- 边框:`1px solid --border`
|
||||
- 圆角:`4px`(`--fluent-radius-medium`)
|
||||
- Focus ring:`0 0 0 2px var(--fluent-primary-tint-20)`(外发光,不占布局)
|
||||
- 内边距:`8px 12px`
|
||||
- 颜色:`--text-primary`
|
||||
- 占位符:`--text-tertiary`
|
||||
|
||||
### 12.5 表格 Table
|
||||
|
||||
- 表头背景:`--bg-elevated`
|
||||
- 表头字重:`600`
|
||||
@@ -157,56 +448,122 @@ Ant Design v5 四级圆角体系:
|
||||
- 单元格内边距:`10px 14px`
|
||||
- 边框:`1px solid --border`
|
||||
- 表头 sticky top: 0
|
||||
- 行悬停:背景色变为 `--color-primary-bg`
|
||||
- 行悬停:背景色变为 `--color-primary-bg`(`tint-30`)
|
||||
- 圆角:`6px`(整表圆角)
|
||||
|
||||
### 7.4 代码 Code
|
||||
### 12.6 代码 Code
|
||||
|
||||
- 背景:`--bg-elevated`
|
||||
- 内边距:`2px 8px`
|
||||
- 圆角:`4px`
|
||||
- 字号:`13px`
|
||||
- 字体:monospace
|
||||
- 颜色:`--color-success`(暗色主题)/ `--color-primary`(亮色主题)
|
||||
- 字体:`--fluent-font-family-monospace`
|
||||
- 颜色:`--color-primary`
|
||||
|
||||
### 7.5 代码块 CodeBlock
|
||||
### 12.7 代码块 CodeBlock
|
||||
|
||||
- 背景:`--bg-elevated`
|
||||
- 边框:`1px solid --border`
|
||||
- 圆角:`8px`
|
||||
- 圆角:`6px`(`--radius-md`)
|
||||
- 内边距:`16px`
|
||||
- 行高:`1.7`
|
||||
- 字体:`--fluent-font-family-monospace`
|
||||
|
||||
### 12.8 导航项 NavItem(侧栏)
|
||||
|
||||
- 圆角:`4px`(`--radius-sm`)
|
||||
- 内边距:`8px 12px`
|
||||
- 激活态背景:`--fluent-primary-tint-30`(`#DEECF9`)
|
||||
- 激活态文字:`--color-primary`
|
||||
- 激活态字重:`500`
|
||||
- hover 背景:`--bg-elevated`
|
||||
- 移动端最小高度:`44px`(触控友好)
|
||||
|
||||
---
|
||||
|
||||
## 8. 主题
|
||||
## 13. 渐变色
|
||||
|
||||
- **索引页(`index.html`)**:支持亮色/暗色双主题,通过 `data-theme` 属性 + localStorage 键 `wiki-theme` 持久化,同时跟随 `prefers-color-scheme: dark` 系统偏好
|
||||
- **报告页(`{主题}/报告/*.html`)**:统一使用**亮色主题**,不定义暗色 CSS 变量
|
||||
| 用途 | 值 |
|
||||
|------|-----|
|
||||
| 标题渐变 | `linear-gradient(135deg, #0078D4 0%, #2B88D8 100%)` |
|
||||
| 强调渐变 | `linear-gradient(135deg, #0078D4 0%, #106EBE 100%)` |
|
||||
|
||||
亮色/暗色两套颜色 Token 值在 §1 中已定义,索引页 `:root` 和 `[data-theme="dark"]` 选择器分别引用。
|
||||
> **注意**:旧版标题渐变包含 `#722ED1`(紫色),约 34 个文件在 HTML 中直接硬编码该值。这些文件在独立打开时不使用此规范;通过 `index.html` iframe 导航时才能继承 CSS 变量。
|
||||
|
||||
---
|
||||
|
||||
## 9. 动画与过渡
|
||||
## 14. 主题架构
|
||||
|
||||
| 元素 | 过渡 |
|
||||
|------|------|
|
||||
| 卡片悬停 | `all 0.2s ease` |
|
||||
| 链接颜色 | `color 0.15s ease` |
|
||||
| 侧栏导航激活态 | `all 0.15s ease` |
|
||||
| 滚动指示器 | `all 0.15s ease` |
|
||||
- **索引页(`index.html`)**:支持亮色/暗色双主题,通过 `data-theme` 属性切换
|
||||
- 优先级:`localStorage('wiki-theme')` → `prefers-color-scheme: dark` 系统偏好 → light
|
||||
- 暗色模式使用 Fluent 2 暗色中性色 + `#479EF5` 品牌色
|
||||
- 亮色模式背景使用 `#FAF9F8`(Fluent neutral-2)
|
||||
- **报告页**:统一使用**亮色主题**,不定义暗色 CSS 变量。通过 `index.html` iframe 导航时继承 Token 值
|
||||
|
||||
---
|
||||
|
||||
## 10. 响应式断点
|
||||
## 15. 向后兼容矩阵
|
||||
|
||||
| 断点 | 值 | 说明 |
|
||||
|------|------|------|
|
||||
| sm | 576px | 手机横屏 |
|
||||
| md | 768px | 平板竖屏 |
|
||||
| lg | 992px | 平板横屏 |
|
||||
| xl | 1200px | 桌面 |
|
||||
### 15.1 已迁移(旧名 = 新值)
|
||||
|
||||
- `≤768px`:隐藏侧栏,全宽内容
|
||||
- `≤992px`:缩小侧栏至 220px,减小内边距
|
||||
- `>992px`:完整布局
|
||||
| 旧 Token | 新值来源 | 视觉变化 |
|
||||
|----------|---------|---------|
|
||||
| `--color-primary` | Fluent `#0078D4` | 偏青蓝(原 `#1677FF` 偏紫蓝) |
|
||||
| `--color-primary-hover` | Fluent shade-10 `#106EBE` | 更深 |
|
||||
| `--color-primary-active` | Fluent shade-20 `#005A9E` | 更深 |
|
||||
| `--color-primary-bg` | Fluent tint-30 `#DEECF9` | 几乎一致 |
|
||||
| `--color-success` | Fluent `#107C10` | **显著变化**:亮绿→深绿 |
|
||||
| `--color-warning` | Fluent `#FF8C00` | 琥珀→橙色 |
|
||||
| `--color-error` | 保留 `#FF4D4F` | 不变 |
|
||||
| `--bg` | Fluent neutral-2 `#FAF9F8` | 微调 |
|
||||
| `--bg-elevated` | Fluent neutral-4 `#F3F2F1` | 微调 |
|
||||
| `--border` | Fluent neutral-10 `#E1DFDD` | 微调 |
|
||||
| `--text-primary/secondary/tertiary` | Fluent neutral-80/70/60 | 暗色文本对比度改善 |
|
||||
| `--radius-sm/md/lg` | Fluent 4/6/8px | 整体更方正 |
|
||||
| `--shadow-sm/md/lg` | Fluent elevation 2/4/8 | 更轻、更自然 |
|
||||
| `--gradient-title` | 纯蓝渐变(移除紫色) | 34 个硬编码文件不受影响 |
|
||||
|
||||
### 15.2 未迁移(独立 Token 体系的文件)
|
||||
|
||||
以下 7 个文件使用独立的命名体系,不受本次迁移影响:
|
||||
|
||||
| 文件 | Token 体系 | 命名示例 |
|
||||
|------|-----------|---------|
|
||||
| `深国际综合改革方案/index.html` | 自定 + 部分标准 | `--primary: #1a3a5c`, `--accent: #c8102e` |
|
||||
| `深国际综合改革方案/报告/*.html` (3 文件) | 自定 + 部分标准 | 同上 |
|
||||
| `YqBoot系统说明书/系统说明书.html` | Google 风格 | `--primary: #1a73e8` |
|
||||
| `YqBoot系统说明书/系统说明书-演示文稿.html` | Google 风格 | 同上 |
|
||||
| `政府审批流解决方案/政府审批流解决方案.html` | 暗红金色 | `--primary: #8B0000`, `--accent: #C9A84C` |
|
||||
| `中医馆内部管理系统/报告/*.html` (2 文件) | 多色功能色 | `--green/red/orange/purple` |
|
||||
| `szihl-soe-reform-report.html` | 混合 | 标准 + `--accent: #c8102e` + 暗色模式 |
|
||||
|
||||
### 15.3 废弃 Token
|
||||
|
||||
| Token | 原因 |
|
||||
|-------|------|
|
||||
| `--color-info` | 定义但从未被 `var()` 引用 |
|
||||
|
||||
---
|
||||
|
||||
## 16. 图标规范
|
||||
|
||||
| 规则 | Do | Don't |
|
||||
|------|----|----- |
|
||||
| 图标来源 | SVG Icon 库(Heroicons / Lucide) | Emoji 作为 UI 图标 |
|
||||
| 图标尺寸 | 固定 24×24 viewBox,`w-6 h-6` | 混合不同尺寸 |
|
||||
| 品牌 Logo | 从 Simple Icons 获取官方 SVG | 猜测或使用错误路径 |
|
||||
| 悬停反馈 | `transition-colors duration-200` | 瞬时状态变化 |
|
||||
| 触控目标 | 最小 44×44px | 不可点击区域 |
|
||||
|
||||
---
|
||||
|
||||
## 参考资料
|
||||
|
||||
- [Fluent 2 Design System](https://fluent2.microsoft.design)
|
||||
- [Fluent 2 Design Tokens](https://fluent2.microsoft.design/design-tokens)
|
||||
- [Fluent 2 Typography](https://fluent2.microsoft.design/typography)
|
||||
- [Fluent 2 Layout](https://fluent2.microsoft.design/layout)
|
||||
- [Fluent 2 Shapes](https://fluent2.microsoft.design/shapes)
|
||||
- [Windows 11 Design Principles](https://learn.microsoft.com/en-us/windows/apps/design/design-principles)
|
||||
- [Windows 11 Typography](https://learn.microsoft.com/en-gb/windows/apps/design/signature-experiences/typography)
|
||||
- [Fluent UI Web Components Design Tokens](https://learn.microsoft.com/en-gb/fluent-ui/web-components/design-system/design-tokens)
|
||||
|
||||
Reference in New Issue
Block a user