注意事项与限制
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 声明。