Ordo UI
Foundations

Elevation

阴影政策与 shadow-xs

P0 采用单阴影政策:全站只允许 shadow-xs,不用投影时用 shadow-none。

--shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.05);
<Card className="shadow-xs" />
<Card className="shadow-none" />

为什么只有一档

  • 现有产品的层次主要靠描边、背景色与层级,不靠重阴影。
  • 多档阴影会让暗色模式下的边界更难控制。
  • 单档政策由 lint:spacing 强制;任意 shadow-[...] 由 lint:tokens 拦截。

例外

Toast / 决策卡堆等需要复合阴影的组件目前有少量任意值,已登记为待收编;P1 会引入 --shadow-elevation-* 或统一改为 color-mix token。

面板磨砂

侧栏、吸顶头、保存栏与 AI 面板的毛玻璃统一走三档 token,不再各写透明度与 blur:

token 组用途bg / blur / border
--panel-strong-*AI 主面板、强分离浮层壳background/95 · 24px · border/80
--panel-*设置吸顶头、StickySaveBar、右侧栏background/85 · 8px · border/60
--panel-subtle-*侧栏内嵌折叠面板card/80 · 4px · border/60
<div className="border-(--panel-border) bg-(--panel-bg) backdrop-blur-(--panel-blur)" />

规则

  • 不要用 shadow-sm / shadow-md / shadow-lg。
  • 暗色下不要靠黑色阴影制造层次;优先用 border / bg-muted / ring。
  • 磨砂面板用 --panel-* 三档,不要新写 bg-background/xx + backdrop-blur-xx 组合。