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组合。