Skip to content

设计 ​

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 为准。

页面索引 ​

  • 色彩:语义角色、状态颜色和对比度边界。
  • 深色模式:模式切换、层级和阅读舒适度。
  • 字体:字阶、行高、字重和数字/代码字体。
  • 图标:无内置图标库时的插槽、尺寸和可访问性契约。
  • 布局:容器、间距、断点和响应式行为。
  • 动效:时长、缓动、减少动效和动效取舍。