Ordo UI
Foundations

Density

compact / comfortable / spacious 三档密度,只覆盖控件高度与间距 token。

Density

密度是主题的第四维:不改颜色与圆角,只覆盖控件高度、单元纵向内距和页面级间距。

<ThemeProvider theme={{ density: 'compact' }}>
  <App />
</ThemeProvider>

CSS-only 接入直接挂属性:

<html data-density="compact">

三档取值

Tokencompactcomfortable(默认)spacious
--spacing-control-xs20px24px28px
--spacing-control-sm28px32px36px
--spacing-control-md32px36px40px
--spacing-control-lg36px40px44px
--spacing-cell-y4px6px8px
--spacing-gutter12px16px20px
--spacing-section20px24px28px
--spacing-page20px24px28px

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,便于组合回归。