mirror of
https://github.com/wwiinnddyy/LanMountainDesktop.git
synced 2026-06-20 23:54:26 +08:00
49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
# 视觉规范
|
|
|
|
## 中文
|
|
|
|
本规范用于统一阑山桌面的主题色、玻璃效果和基础视觉语义。
|
|
|
|
### 颜色角色
|
|
|
|
- `Primary`：品牌主色
|
|
- `Secondary`：辅助色
|
|
- `Accent`：强调色与选中态主色
|
|
- `OnAccent`：强调色背景上的文字或图标
|
|
- `SurfaceBase` / `SurfaceRaised` / `SurfaceOverlay`：背景层级
|
|
- `TextPrimary` / `TextSecondary` / `TextMuted` / `TextAccent`：文本层级
|
|
|
|
### 使用规则
|
|
|
|
- 主按钮和主要导航选中态使用 `Accent + OnAccent`
|
|
- 次级操作和输入控件优先使用语义背景色，不直接写死颜色
|
|
- 页面层只使用资源键和语义类名，不写业务颜色常量
|
|
|
|
### 玻璃效果层级
|
|
|
|
- `glass-overlay`：最外层遮罩
|
|
- `glass-strong`：主要大容器
|
|
- `glass-panel`：子区域、小面板、卡片
|
|
|
|
### 形状与圆角 (Shape & Corner Radius)
|
|
|
|
- **全局统一**：所有 UI 元素的圆角必须遵循 [圆角设计规范](file:///c:/Users/USER154971/Documents/GitHub/LanMountainDesktop/docs/CORNER_RADIUS_SPEC.md)。
|
|
- **禁止硬编码**：严禁在资源库以外的地方硬编码 `CornerRadius` 数值。
|
|
- **动态适配**：桌面组件必须使用 `DesignCornerRadiusComponent` 动态资源，以支持用户在设置中全局切换“锐利/平衡/圆润/开放”风格。
|
|
|
|
### 可访问性
|
|
|
|
- 正文对比度目标不低于 `4.5:1`
|
|
- 大号文字和重点文字不低于 `3.0:1`
|
|
- 主题服务负责对前景色做自动对比度修正
|
|
|
|
## English
|
|
|
|
This specification defines the visual language of LanMountainDesktop, including theme roles, glass layers, and semantic color usage.
|
|
|
|
### Key rules
|
|
|
|
- use semantic resource keys instead of hard-coded colors
|
|
- keep glass layers visually distinct
|
|
- maintain contrast targets for readability
|