Foundations
Spacing
4px 网格、语义间距与弹窗尺寸
间距以 4px 网格为基线:整数档与 .5 档合法;.25 / .75 档被 lint:spacing 冻结。
语义间距
| Token | 值 | 用途 |
|---|---|---|
--spacing-cell-y | 0.375rem | 密集单元格纵向内距 |
--spacing-gutter | 1rem | 区块内边距 |
--spacing-section | 1.5rem | 分区间距 |
--spacing-page | 1.5rem | 页面级内距 |
对应工具类:p-page、gap-gutter、py-cell-y 等。
控件高度
Button / Input / Select 共用一套控件高度 token:
| Token | comfortable | compact | spacious |
|---|---|---|---|
h-control-xs / size-control-xs | 24px | 20px | 28px |
h-control-sm / size-control-sm | 32px | 28px | 36px |
h-control-md / size-control-md | 36px | 32px | 40px |
h-control-lg / size-control-lg | 40px | 36px | 44px |
<Button size="sm" />
<Input controlSize="sm" />
<Select size="sm" />NumberField 仍保留 coss 的 7.5/8.5/9.5 配方,未并入 P1 控件标度,避免默认视觉出现 2px 偏移。
弹窗尺寸
| Token | 值 |
|---|---|
--spacing-dialog | 95vw |
--spacing-dialog-wide | 90vw |
--spacing-dialog-screen | 95vh |
--spacing-dialog-scroll | 85vh |
--spacing-dialog-full | 90vh |
<DialogContent className="max-w-dialog" />密度
ThemeProvider 写 data-density,P1 已实现三档:
<ThemeProvider theme={{ density: 'compact' }}>| 档位 | 控件高度 | 语义间距 |
|---|---|---|
compact | 20 / 28 / 32 / 36 | cell-y 4px、gutter 12px、section/page 20px |
comfortable | 24 / 32 / 36 / 40 | 默认值 |
spacious | 28 / 36 / 40 / 44 | cell-y 8px、gutter 20px、section/page 28px |
密度只覆盖具体 token,不做乘法;圆角、字号不随密度变化。
规则
- 正向
space-x-*封禁,相邻横向间距用gap-*。 - 负向
-space-x-*仅用于头像/图标叠层。 - 不要用
p-[13px]这类任意值绕过网格。