用途:@chenglou/pretext 是 Cheng Lou 开发的 15KB 零依赖 TypeScript 库,通过 canvas 测量实现无 DOM 的多行文本测量与排版。给定(文本、字体、宽度),返回换行位置、每行宽度、每字素坐标与总高度,无需触发重排。本技能用于构建浏览器创意演示,如文字绕移动图形流动、ASCII 艺术、以文字为几何的游戏、逐字素物理动效、多行收缩包裹 UI 等。
主要能力:提供 prepare/layout(测量高度)、prepareWithSegments/layoutWithLines(固定宽度分行)、layoutNextLineRange/materializeLineRange(流式或可变宽度逐行排版)、measureLineStats/walkLineRanges(无字符串分配的统计)等 API;另有 rich-inline 子路径支持混排字体、标签与提及。
使用方式:单文件自包含 HTML,无构建步骤,通过 esm.sh CDN 引入并固定版本,例如 import { prepare, layout } from "https://esm.sh/@chenglou/pretext@0.0.6"。渲染用 Canvas 2D,字素切分用内置 Intl.Segmenter,交互用原生 DOM 事件。本地验证可运行 python3 -m http.server 8765 后打开页面。
适用场景:文字绕障碍重排、文字几何游戏、碎裂粒子、ASCII 障碍排版、编辑式多栏、动态字体、多行收缩包裹等。
限制:不适用于 CSS 已能解决的静态页面、富文本编辑器、图像转文字或纯 canvas 无文字生成艺术。需注意字体字符串与 CSS 完全一致、prepare 只调用一次、避免每帧重新 prepare、使用 Intl.Segmenter 处理 emoji 与 CJK、通过 esm.sh 而非 unpkg 引入。具体收费、价格与平台支持暂未提供。