用途:@chenglou/pretext 由 Cheng Lou 开发,是一个约 15KB、零依赖的 TypeScript 库,专注于无 DOM 的多行文本测量与排版。输入文本、字体与宽度后,它通过 canvas 测量返回换行位置、每行宽度、逐字形位置与总高度,无需触发页面重排。因为速度快且基于几何计算,它可作为创意原语使用。
主要能力:支持在移动图形周围以 60fps 重排段落、用真实单词构造游戏场景几何、以散文驱动 ASCII 标志、按精确字形起始位置把文字炸成粒子,以及在不反复读取 getBoundingClientRect 的情况下打包多行 UI。库提供 prepare/layout、prepareWithSegments/layoutWithLines、layoutNextLineRange/materializeLineRange、measureLineStats、walkLineRanges 等接口,另有 rich-inline 子路径处理混合字体、标签与提及。
使用方式:单个自包含 HTML 文件,无构建步骤。通过 esm.sh CDN 引入并固定版本,例如 import { prepare, layout } from "https://esm.sh/@chenglou/pretext@0.0.6";使用 HTML5 Canvas 2D 渲染,Intl.Segmenter 做字形切分,原生 DOM 事件处理交互。本地可用 python3 -m http.server 8765 启动预览。
适用场景:文字绕移动形状流动、以文本为几何的游戏、逐字形物理动效、非拉丁或混合文字排版生成艺术、多行收缩包裹 UI,以及任何需要在渲染前知道换行的场合。
限制:不适合 CSS 已能解决布局的静态页面、富文本编辑器、图像转文字以及无文字角色的纯 canvas 生成艺术。字体字符串必须与 CSS 完全一致,prepare 应缓存而非每帧调用。官方演示见 chenglou.me/pretext 与 pretext.cool。