Foundations
Density
compact / comfortable / spacious 三档密度,只覆盖控件高度与间距 token。
Density
密度是主题的第四维:不改颜色与圆角,只覆盖控件高度、单元纵向内距和页面级间距。
<ThemeProvider theme={{ density: 'compact' }}>
<App />
</ThemeProvider>CSS-only 接入直接挂属性:
<html data-density="compact">三档取值
| Token | compact | comfortable(默认) | spacious |
|---|---|---|---|
--spacing-control-xs | 20px | 24px | 28px |
--spacing-control-sm | 28px | 32px | 36px |
--spacing-control-md | 32px | 36px | 40px |
--spacing-control-lg | 36px | 40px | 44px |
--spacing-cell-y | 4px | 6px | 8px |
--spacing-gutter | 12px | 16px | 20px |
--spacing-section | 20px | 24px | 28px |
--spacing-page | 20px | 24px | 28px |
comfortable 与改造前的默认值逐值一致;切档不会产生半像素或圆角失真——密度只覆盖具体 token,不做乘法。
消费约定
- Button / Input / Select 共用
--spacing-control-*;NumberField 仍保留 coss 的 7.5/8.5/9.5 配方。 - 页面级间距优先用
gap-gutter/p-page/py-section,不要写固定px-4。 - 表格行高由
--spacing-cell-y驱动;密集表格切compact后应保持文字可读。 - 密度不影响字号、行高与触控目标的最小宽度;移动端仍建议至少
comfortable。
预览
同一画板也覆盖 radius / baseColor / locale / RTL / contrast,便于组合回归。