排版与布局规范 V1

字号 5 级 / 间距 8 的倍数 / 行高区间 / 行长上限 / 组件间距表 / 一屏密度上限 —— 每个数值都可被脚本检查。依据 Material 3、Carbon 8pt、W3C Design Tokens、WCAG 2.2。

01字号阶梯(5 级,比例写死)

级别Token字号用途比例
L1--fs-caption11px辅助说明 / 表头 / 时间戳—
L2--fs-body13px正文 / 表格 / 列表1.18
L3--fs-subtitle16px卡片标题 / 区块小标题1.23
L4--fs-title20px页面标题 / 抽屉标题1.25
L5--fs-display26px关键数字 / 结论句1.30
样张
26 关键数字 / 结论句
20 页面标题
16 卡片标题
13 正文内容
11 辅助说明

只允许这 5 个值;相邻比例 1.18–1.30;大屏整体 ×1.6(正文 ≥26px)。

02间距刻度(8 的倍数)

Token值用途允许 / 禁止
--sp-18px图标与文字 / 标签内距允许
--sp-216px卡片内距 / 表格单元 / 表单行允许
--sp-324px卡片之间 / 栅格 gutter允许
--sp-432px区块之间允许
--sp-548px页面左右边距 / 大屏上边距允许
--sp-664px大屏区块间距允许
4px4px仅图标内距 / 徽标内距唯一例外
其它2/3/5/6/10/12/14/15/18/20/22—禁止

03行高

场景行高说明判定
正文段落1.5–1.7(取 1.6)中文推荐 1.6区间内通过
标题 L4/L51.2–1.3(取 1.25)单行 1.2区间内通过
表格行36 / 44 / 52三档固定白名单
列表行36 / 52单行 / 双行白名单
按钮高度28 / 32 / 40小 / 常规 / 大白名单

04行长

文案类型上限落地
正文段落70 字符 / 35 汉字max-width:70ch
说明文字80 字符 / 40 汉字max-width:80ch
表格单元24 汉字,超出省略text-overflow:ellipsis
标题单行 ≤20 汉字2 行则 line-height:1.6

05组件间距表

组件内距元素间距外边距
卡片16卡内区块 16卡片之间 24
表格单元 16 / 8行高 44与区块 24
表单输入 8 / 16标签与输入 8;行间 24与按钮 24
按钮左右 16(小 12)按钮之间 8与内容 16
Tab左右 16 / 上下 12Tab 之间 0(1px 分隔)与内容 16
抽屉16标题与正文 16宽 480 / 640
弹窗24标题与正文 16按钮区 24

06一屏密度上限

项上限超过怎么办
区块数≤ 7合并 / 拆到二级页
KPI 卡≤ 4改表格
同屏字号级别≤ 3收敛到 11/13/16
主行动1 个其余降为次级
Tab≤ 4改左侧导航
表格列≤ 8进「列设置」
抽屉字段≤ 12改独立页
正文块宽≤ 760px文档页限宽

07可机械检查(C1–C10)

C1字号白名单 11/13/16/20/26
C2间距白名单 4/8/16/24/32/48/64
C3行高区间与行高三档
C4正文 max-width ≤70ch / 760px
C5区块 ≤7 · KPI ≤4 · Tab ≤4
C6触控高度 ≥44(移动端)
C7390 scrollWidth = 390
C8主视觉面积 ≥30%
C9同屏卡片内距全等
C10禁用值 2/3/5/6/10/12/14/15px

08试点页 Before → After

警报中心 BEFORE

字号 9/10/11 混用(9 处 9px)
间距 6/10/14px 混用
表格行高 32
三栏 380/780/380
区块 9 个
行长无限制(最长 96 字)

警报中心 AFTER

字号 11/13/16(三级)
间距 8/16/24
行高 44
三栏 381/786/381
区块 7 个
正文 70ch,超长省略

总控台 BEFORE

23 个区块平铺
字号 8 级(11–26)
间距 2/5/6/10/12/14/20
无数值主视觉
4 个同级主按钮

总控台 AFTER

7 个区块
字号 5 级(11–26)
间距 8/16/24/32
主视觉 ≥30% 面积
1 主行动 + 2 次级

交流区 BEFORE

行高 28
字号 10/11/12
头像间距 6
消息内距 8/10/12
按钮 24×24

交流区 AFTER

行高 44(双行 52)
字号 11/13
头像间距 8
消息内距 16/8
按钮 ≥44×44

09Token(复制即用)

:root{



  /* 字号 5 级 */



  --fs-caption:11px; --fs-body:13px; --fs-subtitle:16px; --fs-title:20px; --fs-display:26px;



  /* 间距 8 的倍数 */



  --sp-1:8px; --sp-2:16px; --sp-3:24px; --sp-4:32px; --sp-5:48px; --sp-6:64px;



  /* 行高 */



  --lh-body:1.6; --lh-title:1.25; --row-compact:36px; --row:44px; --row-loose:52px;



  /* 行长 / 密度 */



  --measure-body:70ch; --measure-doc:760px;



  --max-blocks:7; --max-kpi:4; --max-tabs:4; --max-cols:8;



}

十、维护与更新口径

本规范由设计岗·PD 维护:新增/修改数值须先出 ADR 并同步 layout-rules 契约;页面侧以线上检测为准(C1 字号、C6 触控、C7 390、C10 间距),每次唤醒巡检复跑一次,违规即修。

DP-LAYOUT-V1 · 设计岗·PD · 2026-10-29—依据 Material 3 · Carbon 8pt · W3C DTCG · WCAG 2.2
▸ 规范怎么用

新页先套 Token 与组件间距表,再跑 C1–C10;数值不在白名单直接退回。试点页 before/after 为同一视口对比,改版前后各截一张即可判。

首页交流区需求总表需求确认页面清单文档中心接口文档验收报告
实时数据读取中… 源 /api/zt/pages/list