Ordo UI
Foundations

Spacing

4px 网格、语义间距与弹窗尺寸

间距以 4px 网格为基线:整数档与 .5 档合法;.25 / .75 档被 lint:spacing 冻结。

语义间距

Token值用途
--spacing-cell-y0.375rem密集单元格纵向内距
--spacing-gutter1rem区块内边距
--spacing-section1.5rem分区间距
--spacing-page1.5rem页面级内距

对应工具类:p-page、gap-gutter、py-cell-y 等。

控件高度

Button / Input / Select 共用一套控件高度 token:

Tokencomfortablecompactspacious
h-control-xs / size-control-xs24px20px28px
h-control-sm / size-control-sm32px28px36px
h-control-md / size-control-md36px32px40px
h-control-lg / size-control-lg40px36px44px
<Button size="sm" />
<Input controlSize="sm" />
<Select size="sm" />

NumberField 仍保留 coss 的 7.5/8.5/9.5 配方,未并入 P1 控件标度,避免默认视觉出现 2px 偏移。

弹窗尺寸

Token值
--spacing-dialog95vw
--spacing-dialog-wide90vw
--spacing-dialog-screen95vh
--spacing-dialog-scroll85vh
--spacing-dialog-full90vh
<DialogContent className="max-w-dialog" />

密度

ThemeProvider 写 data-density,P1 已实现三档:

<ThemeProvider theme={{ density: 'compact' }}>
档位控件高度语义间距
compact20 / 28 / 32 / 36cell-y 4px、gutter 12px、section/page 20px
comfortable24 / 32 / 36 / 40默认值
spacious28 / 36 / 40 / 44cell-y 8px、gutter 20px、section/page 28px

密度只覆盖具体 token,不做乘法;圆角、字号不随密度变化。

规则

  • 正向 space-x-* 封禁,相邻横向间距用 gap-*。
  • 负向 -space-x-* 仅用于头像/图标叠层。
  • 不要用 p-[13px] 这类任意值绕过网格。