设计
Yue Design 的设计规范回答一个问题:在没有组件可直接复用时,界面仍然应该如何保持一致、可读和可访问。
这套规范吸收了 TDesign 资料中关于内容优先、层级稳定、舒适阅读和可验证无障碍的原则,但不复制某个产品的品牌色、图标资源或页面结构。Yue 的规则必须能落到 Token、CSS 或组件测试上。
设计原则
| 原则 | Yue 的执行方式 |
|---|---|
| 内容优先 | 文字、数据和主要操作拥有最高视觉权重;装饰不能抢占交互焦点 |
| 层级稳定 | 页面、表面、组件表面、边界和文字使用语义 Token,不在组件中写裸色值 |
| 低干扰 | 深色模式降低背景亮度和阴影干扰;交互状态优先用统一透明度标尺 |
| 可验证 | 正文对比度至少 4.5:1,非文本边界和焦点至少 3:1;门禁在每次构建运行 |
| 尊重偏好 | prefers-reduced-motion、forced-colors 和键盘焦点都属于组件契约 |
| 可组合 | Yue 提供 Token、布局和插槽契约,不垄断应用的图标库、路由或业务视觉 |
设计与代码的边界
@yue-ui/design-tokens提供跨技术栈的颜色、字体、尺寸、布局和动效 Token。@yue-ui/vue提供组件结构、交互状态和可访问性行为。- 文档站的预览控件只是消费方示例,不是新的设计 Token 来源。
- 参考页面位于
refer/design-refer/,只作为研究资料;规范以本目录和包内 CSS 为准。