跳到正文
定位、使用者与职责边界
定位、使用者与职责边界
搜索 YUDS 文档

YUDS 文档

排版层级与文字可读性

三种文字角色各九档如何映射业务用途与四端初始尺度,以及数据文本、放大、多语言和截断展开的可读性要求。

状态:label、prose、heading 三种文字角色各九档已由用户确认(2026-10-19)。D02 由代理依用户授权采用本页 FND-T01-A 全部 27 行四端尺度与系统字体/动态缩放,作为初始设计基线;业务用途映射可修订。实际字形与字体回退、平台 SDK、系统缩放和任务运行均未验收,本页各夹具均未执行。 更新:2026-10-19(三角色九档确认;官方资料读取) 所属章节:视觉与语义基础

基础设计采用与验收边界见视觉与语义基础;本页的特殊条件与来源限制在相应小节就近说明。

1. 排版服务阅读

企业界面的排版首先帮助用户识别对象、理解状态、比较记录和找到下一步。字号、字重、行距、对齐与留白共同建立层级,不能将所有重要信息都放大加粗。高密度来自合理分组和列布局,不来自把正文压到难以辨认。

排版角色与业务重要性关联,但不替代结构语义。看起来像标题的文字必须在适用平台中提供对应结构;为了视觉大小跳过标题层级,或把所有标题做成普通粗体,都妨碍信息导航。

2. 三角色九档与 D02 初始尺度

2026-10-19 用户确认跨平台统一 label、prose、heading 三种文字角色,每种九档;页面标题、字段标签、业务数据、辅助说明等保留为业务用途映射,不是独立字体 Token 角色。沿用 Billgo Standard Design 的尺寸适用范围与无 13px 档位规则。D02 已由代理依用户授权采用本页初始平台尺度与系统字体;实际渲染和任务验收尚未执行。下表是业务用途说明,不新增字号体系。

2.1 业务用途映射(可修订,不新增角色或档位)

业务用途 映射至基础角色 用途与约束
页面标题 heading 当前工作或对象身份;长名称可换行,不隐藏关键区分信息
区块标题 heading 组织内容区域;同层级语义一致,不因卡片大小升级
正文 prose 多行说明、详情和任务内容,保留可持续阅读的行高与行长
字段与控件标签 label;多行说明拆为 prose 标签持久可见;增长时调整布局,不靠裁切硬塞单行
数据文本 单行 label;多行解释 prose 金额和指标用正文数字字体及等宽数字特性(tabular figures),不把整表改为等宽字体
辅助说明 短标签 label;多行说明 prose 单位、条件、来源不可因低强调省略;关键限制就近可见
反馈文本 短状态 label;多行反馈 prose 错误、警告、进度和结果与字段/任务关联,允许内容增长
机器标识与代码 对应 label/prose 的等宽字体(monospace)形式 保持原值及复制能力;不形成第四角色或独立字号体系

映射描述的是角色选择;当前初始档位与字体按 D02 及下方完整 FND-T01-A 表采用,仍需按内容、语言、缩放和任务验证,不声明组件 API 已存在。标题的结构语义与视觉档位分别维护。

同一文字角色可随平台或文字尺度映射到不同值;这种变化不能改写角色含义。

2.2 FND-T01:九档适用范围与 D02 平台尺度

每个角色均有 1x~9x 九档;编号是各平台尺度中的相对档位,不是像素倍数。按已确认的 Billgo 范围:

  • 应用 UI:label/prose 用 1x~3x,heading 用 3x~6x。
  • 文档长文:prose 用 2x~4x,heading 用 3x~7x。
  • 营销:可用各角色全部档位。

长文中的操作控件仍按应用 UI 标签范围,不因嵌入文档获得任意大字号。

以下 FND-T01-A(D02 初始设计采用,真实运行未验证)是全部 27 行×四端的唯一现行尺度表,由代理依据用户授权决定采用。数值为 YUDS 的设计选择,不是平台官方九档,也不声明 Token/API 已发布。每行固定“角色+档位”,屏幕范围沿用上文;原候选表及其状态/单位上下文冻结在历史排版来源,不另维护第二套现行表。

D02 采用理由:应用标签与正文从 12、14、16 的细级差开始,标题从 20 附近建立结构;大档扩大级差,供长文/营销使用。iOS/iPadOS 的常用正文取 17pt 初始值,标题取 20/22/28/34pt 初始值,以便与系统样式比较;Web、Android、HarmonyOS 的常用正文取各自单位的 16 作为初始值,相同数字不表示物理大小相同。Billgo 排版参考提供了相对单位、行高与标题层级的研究起点;其旧 13px Caption 示例与用户已确认的无 13px 档位冲突,本表不采用。最终仍须由中文、真实任务和系统缩放测试验证,并按失败结果修订。

读表规则:Web 列为“字号 rem/无单位行高”,不锁定浏览器根字号;仅在试验根字号为 16 CSS px 时,0.75rem 对应 12 CSS px。iOS 列为“基准字号 pt/基准最小行高 pt;Dynamic Type 缩放参照样式”,基准是系统 Large 文字类别。Android 列为“字号 sp/行高 sp”;HarmonyOS 列为“字号 fp/行高 fp”。所有行的字重列在 Web/Android/HarmonyOS 采用初始数值,在 Apple 分别采用 Medium/Regular/Semibold 系统字重。未设置额外字距,先保持平台字体的默认字距。行高是设计最小值,实际字形超出时增长,不能裁切。

现行初始条目(D02 代理采用;运行未验证) Web rem/最小行高 iOS/iPadOS pt/最小行高;缩放参照 Android sp/行高 HarmonyOS fp/行高 字重
label-1x 0.75/1.4 12/17;caption1 12/17 12/17 500
label-2x 0.875/1.4 14/20;subheadline 14/20 14/20 500
label-3x 1/1.4 17/24;body 16/23 16/23 500
label-4x 1.125/1.4 20/28;title3 18/26 18/26 500
label-5x 1.25/1.4 24/34;title2 20/28 20/28 500
label-6x 1.5/1.4 28/40;title1 24/34 24/34 500
label-7x 1.875/1.4 34/48;largeTitle 30/42 30/42 500
label-8x 2.25/1.4 40/56;largeTitle 36/51 36/51 500
label-9x 3/1.4 48/68;largeTitle 48/68 48/68 500
prose-1x 0.75/1.5 12/18;caption1 12/18 12/18 400
prose-2x 0.875/1.5 16/24;callout 14/21 14/21 400
prose-3x 1/1.5 17/26;body 16/24 16/24 400
prose-4x 1.125/1.5 20/30;title3 18/27 18/27 400
prose-5x 1.25/1.5 24/36;title2 20/30 20/30 400
prose-6x 1.5/1.5 28/42;title1 24/36 24/36 400
prose-7x 1.875/1.5 34/51;largeTitle 30/45 30/45 400
prose-8x 2.25/1.5 40/60;largeTitle 36/54 36/54 400
prose-9x 3/1.5 48/72;largeTitle 48/72 48/72 400
heading-1x 1/1.3 16/21;headline 16/21 16/21 600
heading-2x 1.125/1.3 18/24;headline 18/24 18/24 600
heading-3x 1.25/1.3 20/26;title3 20/26 20/26 600
heading-4x 1.5/1.3 22/29;title2 24/32 24/32 600
heading-5x 1.75/1.3 28/37;title1 28/37 28/37 600
heading-6x 2/1.3 34/45;largeTitle 32/42 32/42 600
heading-7x 2.5/1.3 40/52;largeTitle 40/52 40/52 600
heading-8x 3/1.3 48/63;largeTitle 48/63 48/63 600
heading-9x 4/1.3 64/84;largeTitle 64/84 64/84 600

D02 四端派生与回退规则(适用于每一行)

  • Web:系统字体栈采用 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;等宽形式采用 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace。不下载、提取或打包分发字体文件。字号由 rem 计算,正文和标签按本表行高,标题超过两行时最小行高增至 1.4。单行输入默认 label-3x、多行输入默认 prose-3x,不能以小档追求紧凑。无等宽数字特性的回退字体须更换候选或提供其他对齐方案,不用空格伪造原值。
  • iOS/iPadOS:使用系统字体的 D02 基准值,与表列文本样式的 Dynamic Type 度量机制组合;这里的“参照”不声称该字号等于系统样式原值。系统文字偏好改变时,字体及行距须通过对应样式的缩放机制重新计算,并至少容纳实际字形行高;不得用固定 pt 容器、统一线性倍数或人为最大字号上限裁切。三行以上标题仍增长行距。此处引用 UIFontMetrics 官方机制(读取于 2026-10-19),不批准 YUDS 包装 API。
  • Android:采用 sp 字号和 sp 行高,由平台应用字体缩放;字体选型采用系统字体;主题若另换字体,须独立登记使用范围、许可与回退证据。表内数值是 YUDS 初始尺度对原生样式的设计映射,不声称是 Material 原值。在小号、最大系统文字及非线性缩放下重测字形行高,不以 fontScale 乘法重建。多行容器增长;不得拿 sp 当 padding 单位。
  • HarmonyOS:以系统字体、fp 字号和 fp 行高形成初始设计,逐行按表验证。官方 Text 说明数值字号和行高的单位为 fp,且自适应字号开启时会覆盖 fontSize;因此本设计不同时开启为塞入固定容器而自动缩字的路径。maxFontScale 未设置时不限制最大缩放,不能为通过截图而限制系统放大。官方事实来自 Text 与 像素单位(读取于 2026-10-19);数值、九档以及 YUDS 映射均为代理依授权所做的设计选择,不是 HarmonyOS 官方推荐字号。

每行的等宽形式复用同一初始尺寸与增长规则,另核平台可用的等宽字形、字重和许可;普通金额仍用正文数字字体+等宽数字。每行均要求记录实际字体、缺字回退、系统版本/SDK,以及默认和最大文字类别下的布局结果。字体回退和精确字形结果尚未知,不计作通过;任何一端也未形成可发布实现。

设计采用与证据门禁

全部 27 项×四端初始尺度已由 D02 采用;实际字体版本/回退、目标 SDK 绑定、系统缩放和任务运行仍未完成。首次实现须对所有使用的档位执行 T01-A,未使用的档位也不得标为已验证。HarmonyOS 官方单位和 Text 机制不是所有设备/SDK 行为一致的证据。

文档夹具 T01-A

  • 正文档位:对同一付款计划比较 prose-2x 与 prose-3x。Web/Android/HarmonyOS 初始值依次为 14→16(各自单位),iOS 依次为 16→17pt;行高和系统缩放规则按对应行。两个评审者应得到同一组采用值。
  • 标题档位:再比较 heading-3x 与 heading-6x:Web/Android/HarmonyOS 为 20→32,iOS 为 20→34pt。
  • 检查:默认文字下检查对象、币种、负号和标题层级;改为最大系统文字、长中文、RTL 与字体回退后允许重排,不自动降档。
  • 失败注入(任一即判失败):将代理采用值伪称为用户逐值亲自批准;将 14sp 换成 14px;以自适应缩字覆盖 fp 候选;固定行高裁掉重音或负号。
  • 状态:文档推演可确定输入与预期;四端实际运行未执行。

官方事实

Apple 推荐使用内建文本样式以支持 Dynamic Type,并要求在大字下考虑堆叠与减少列数;Android 14 起支持最高 200% 的非线性字体缩放,文字及行高应使用适当的 sp,不能用 sp 作布局 padding,也不能手算统一倍数。上述事实说明平台机制;YUDS 字号的采用依据是 D02 代理决定,并非这些官方页面。读取于 2026-10-19:Apple Typography、Android 14 字体缩放、Material 3 Typography。

D02 采用与撤回

选择平台系统字体+表列可缩放尺度,不下载、提取或再分发字体文件。统一品牌字体保留为未来的变更,届时须明确许可,并完成完整的回退/缩放评估。若真实任务出现混淆、剪切或层级不足,修订受影响平台的值并重验,保留三角色各九档,不自动缩字。字体版本、缺字回退与实现 API 仍待记录。

3. 字体与历史原型候选

选择字体需要同时检查:中文、拉丁字母、数字及标点覆盖,常用字与生僻名称,数字 0 与字母 O、数字 1 与字母 I 等的辨识,实际可用字重、系统回退和加载失败,字体授权与分发条件。未确定专用字体前可试验平台可用字体;不能未经许可将品牌专有字体打包到所有端。

不要仅因为拉丁字母显得偏小就统一放大整行,也不要为中英文视觉齐平而压低中文行高。以混合内容的实际字形、基线和重音字符为依据,保证上下不被裁切。

历史原型候选(未批准,非九档映射)

以下仅保留用于追溯最初的比较,不是现行字号推荐或品牌决定:正文可比较“16/24”与数据区“14/20”的字号/行高组合,区块标题可比较“18/26”,页面标题可比较“24/32”。这些数字若用于 Web 原型,按 CSS px 记录,其他平台另行映射。辅助说明不应被默认压到更小一档,需由任务可读性决定。所有候选都要经中文、长文本、缩放与真实设备验证后才能采用。

4. 数据文本与对齐

金额、比率和同单位数量在列中采用一致的数位对齐,通常按右侧或小数点对齐;业务金额、表格数字和关键指标使用正文数字字体及等宽数字特性。等宽数字只统一数字宽度,不等于整套等宽字体,也不要求整张表使用等宽字体。表头与其列保持清楚对应。

标识符不是数值,合同号、邮编或带前导零的资产编号不按金额规则格式化或排序。百分号、负号、单位和状态说明不得因固定列宽被裁掉。不同币种不能因视觉对齐就视为可直接加总,精度与币种规则见指标、数值与时间格式。

日期、时间、编号和长名称采用不同的换行策略。自然语言优先按语言规则换行;长标识可提供可访问的完整值及复制方式。省略号仅适用于用户仍能识别对象、且有明确完整内容入口的场景。关键金额、风险和错误内容不以悬浮提示作为唯一的完整呈现。

5. 放大、字距与容器

D05 已采用的 Web 设计验收目标包含 WCAG 2.2 SC 1.4.4:除条款列明的字幕和文字图像外,文字可在不依赖辅助技术的情况下放大到 200%,不丢内容或功能。只把外层画面缩放、却裁掉控件文字,不算通过。Resize Text 官方说明

对支持相关文字样式的标记语言,SC 1.4.12 测试用户调整到行高 1.5 倍、段后距 2 倍、字距 0.12 倍、词距 0.16 倍字号时,内容及功能仍保留;不适用某些属性的语言和书写系统按条款例外处理。这是允许调整后的耐受要求,不是强迫所有默认排版采用这些值。Text Spacing 官方说明

实现应优先采用可增长容器和合理的最小尺寸。标签、帮助、校验信息与按钮组合需要一起测试,不以只放大正文段落代替完整任务验证。固定表头、底部操作栏和弹层不能在放大后占满视窗而遮住当前编辑内容。

6. 多语言、FND-T02 与 FND-T03

界面必须允许标签增长和复数形式变化。初步测试可用比现有中文明显更长的伪本地化样例暴露问题,但“增长 50%”等测试数据只能作为试验条件,不能当作所有语言的固定上限。字体回退、文本方向和本地化格式分别记录。

RTL 界面中不要镜像字符本身或数字序列。自然语言段落按其方向排版,金额、编号及混合文本保留正确的符号顺序。具体的内容隔离与标签原则见界面文案、术语与多语言;布局镜像见布局、响应式与信息密度。

6.1 FND-T02:增长、回退与完整值

正文和错误容器以内容计算高度;多行说明不使用单行 label 硬塞。标签增长时先换排或把解释拆成 prose,不能自动缩小文字到下一档。关键金额、币种、正负号、权限和风险说明须完整可取得;对象长名可截断的前提是仍有独立的身份信息,以及键盘、触控均可打开的完整值入口。不能只有 hover。

指定字体缺字或加载失败时使用平台回退,不替换业务原字符;记录实际使用的字体及未覆盖的字符。长中文名、组合重音、阿拉伯字形连接、emoji 与中英混排都参与检查。改变文字尺度、RTL 或字体时重新计算容器,不清空输入或重置选择。

6.2 FND-T03:数值与机器文本的阅读契约

金额和指标用正文数字字体的等宽数字特性;标识符、代码、哈希用相应角色的等宽字体形式,不新增公共角色。字符按原顺序保留,金额的读屏信息包含币种、负号与单位,编号不被金额格式化器吞掉前导零。视觉等宽和读屏语义分别验收;不能把用空格对齐的字符串当作数据值或可访问名称。

文档夹具 输入与动作 正常预期 失败注入与判定
T02 大字与回退 长中文合同名、阿拉伯公司名、两行错误;字体不可用后放大文字 系统回退可读;标签重排;错误和主操作均能到达;已输入金额保留 固定行高裁掉负号/错误,或降字号避让:失败
T03 数字与编号 金额“−1,234.50 USD”及编号“000123”;键盘打开完整值并复制 金额表达币种及负值;编号复制仍是 000123,读屏按身份信息理解 将编号变成 123,或只让鼠标看全金额:失败

以上为文档预期,字体渲染、动态文字与读屏实测均未执行。

7. PRM-TEXT 文本、标签、标题与展开

7.1 语义职责与解剖

Text 用于一般内容,Label 为具体字段命名,Title/Heading 表达结构,Description 补充说明;视觉字重/字号不决定语义角色。页面标题可采用 heading 的某一档,但 HTML heading 级别按内容树选择,不从九档序号机械映射 h1–h9。点击字段标签可聚焦对应输入,组标签关联整组,而非随意指向第一个字段。通用文本默认不进入 Tab 顺序,不因为可选复制就包装成按钮。

每个呈现对象声明原文、语言/方向、用途、可完整披露的内容、截断策略与必要的语义关联。正文、字段标签、帮助与错误的 ID 不互相覆盖;更新错误时保留帮助关系。值未知时用明确的占位说明,不以空字符串伪装没有内容。富文本只呈现允许的结构与安全链接,不让用户内容注入任意交互或伪造系统权限提示。

7.2 增长、截断与展开

影响当前动作的限制、后果、关键单位及风险必须在当前操作上下文中直接可见,不能只放在展开/全文入口里;任何摘要都不能省掉否定词而反转原意。普通长正文的完整内容优先自然重排;单行/多行截断只是有限空间下的呈现,必须为必要的完整信息提供键盘、触控及读屏均可获取的路径。截断发生在字素边界,不切断 emoji、组合字符、双向文本或关键否定词。数据身份的中间省略可以保留起区分作用的前后缀,但仍提供明确的完整查看。展示摘要与可访问名称须表达相同语义,不能视觉上说已完成、读屏还报旧错误。

可展开文本使用有名称的按钮表示展开状态,完整正文仍是可阅读的文本,而不是按钮名称。展开后保留触发按钮的焦点,内容按阅读顺序出现;收起时若焦点位于将被隐藏的链接或操作上,先回到展开按钮,不能留在隐藏内容中。外部深链或查错定位到隐藏内容时,先展开有效目标;不能只因窗口变窄就自动收起正在阅读的段落。复制全文的独立动作须明确复制范围,成功必须来自真实的剪贴板结果;失败时不提示已复制,也不能悄悄复制受限的隐藏值。

7.3 状态与组合

字体回退不改变文义;字体尚在加载或加载失败时保持可读的备用字体,不用骨架遮掉已有正文。异步名称更新按对象 ID/授权版本绑定,重排时不把另一对象的名字填进原节点。标题改名通常不抢焦点,不反复以 live 方式广播整页结构;必要的更新使用所属任务的通告策略。只读数据可以选择复制,禁用仅适用于确有动作的入口。长标签允许换行,数值与单位成组,但不以无界的不换行撑破页面。

源依据:W3C Headings 与 APG Disclosure(2026-10-19 读取正文);原生层级与展开按钮状态有来源。剪贴板范围、动态内容和收起时的焦点保护为 YUDS 推导,字号与系统字体按 D02 采用;具体 API 与实际字体使用/回退证据仍待记录,不授权分发字体文件。

7.4 精确夹具(全部未执行)

  • PRM-TEXT-F01:视觉 heading 第 7 档用于章节子标题,文档层级应为 h2。预期语义为 h2,不生成 h7,不把九档当作结构级别。
  • PRM-TEXT-F02:标签“名称”关联输入 A,帮助与错误同时存在;激活该标签。预期焦点到 A,帮助与错误均可获取,不因错误出现而丢失帮助。
  • PRM-TEXT-F03:截断内容含“不得删除”及组合 emoji;在窄窗中放大。预期“不得删除”在当前相关动作旁直接可见,不需展开才知道;普通长文有显式全文入口,文字不切断字素,也不只能靠 hover 获得。
  • PRM-TEXT-F04:展开内容内的链接 B 当前聚焦;外部操作将其收起。预期先回到展开按钮再隐藏 B,按钮报告已收起;链接不再可聚焦。
  • PRM-TEXT-F05:复制全文请求被浏览器拒绝。预期保留正文可选复制,并说明未复制,成功反馈为 0;撤权后旧全文不能通过复制动作输出。

来源和证据限制见本组来源。

8. 正反例与验收

合适 不合适
合同名可显示两行,旁边独立保留编号;金额列使用等宽数字、同精度对齐;备注自然换行;变窄时把辅助列移入可访问详情,并保留辨认对象所需的名称与编号。 为保持 32 像素固定行高,将合同名、币种与错误说明全部裁切;悬浮时才可看到完整金额,触控和键盘用户无法核查。
提交错误紧邻字段显示,正文大小可读,并与字段建立程序关联;错误长度增长时,下方内容顺延。 用低对比小字“请检查输入”统一代替所有字段错误,表单视觉整齐,却无法定位问题。

使用同一组内容测试默认与放大文字:含中文生僻字的对象名、中英文混排的公司名、长编号、负数、千分位金额、日期时区、两段帮助和多行错误。若拟支持相应语言,再加入阿拉伯语、希伯来语或其他真实文本,不只用翻转的英文做验收。

  • 信息层级与可访问结构一致,标题可以帮助定位内容。
  • 关键符号、金额、单位和错误没有被截断。
  • 字体未加载时仍可读可用,回退不会使主要操作被遮住。
  • 缩放与字距调整不丢内容、焦点或功能。
  • 数字列能比较,标识符保持原样,完整值入口可由键盘与触控使用。
  • 记录 D02 采用值或已登记的变更、平台、实际字体版本、测试结果及未执行范围。

D02 已选择系统字体作为初始设计;上述真实字形、视觉与任务测试仍未执行。

相关:布局、响应式与信息密度、界面文案、术语与多语言、数据表与交互网格契约。

历史补记:2026-10-19 三角色九档确认原文

现行语义见第 2 节;以下保留 2026-10-19 追加确认的记录。Geist/系统字体为可评估方向,未批准选型、许可或实际渲染。

YUDS 统一 label、prose、heading 三个基础文字角色,每个角色九档。原有页面标题、字段标签、数据文本、辅助说明等分类继续作为业务用途映射,不构成第二套独立尺寸 Token。标题角色包含字重;多行阅读与单行标签分别采用相应行高规则。

业务金额、财务表格和关键指标使用正文数字字体及 tabular figures;机器标识、代码、路径、哈希、版本等使用 monospace。Web 可以采用 Geist 字体,原生端可采用系统字体,但角色和档位语义保持一致。Billgo 标准不设 13px 档位。本文此前列出的具体字号仅是实验候选,不视为已批准的九档实际数值。平台映射、中文排版及运行验收仍待完成。