注意事项与限制

Pretext 瞄准常见 Web 排版默认行为,但并非完整排版引擎。下列条目摘自官方 README 精神,集成时请对照你的设计稿与目标浏览器。

与 CSS 对齐

测量用的 font 字符串应与页面上真实文本的 CSS font(字号、字重、样式、族)一致;lineHeight 应与 line-height 一致,否则像素级结果可能与 DOM 渲染有偏差。

默认目标行为

库当前主要对齐类似以下的组合(具体以官方文档为准):

  • white-space: normal(或使用 pre-wrap 模式时的 pre-wrap 语义)
  • word-break: normal
  • overflow-wrap: break-word
  • line-break: auto

在极窄宽度下仍可能在字素边界处断词内字符,以模拟 break-word。

pre-wrap 模式

传入 { whiteSpace: 'pre-wrap' } 时,普通空格、制表符与换行会保留;tab 按常见浏览器的 8 格对齐理解。

字体名

在 macOS 上,将 system-ui 作为唯一字体族可能导致测量与预期不一致;官方建议改用具体字体族名。

演示

本站演示页使用通用无衬线栈;若你需要与生产环境像素级一致,请在本地把 DEMO_FONT 改成与产品相同的 font 声明。