产品简介
expo-pretext 是一个React Native库,用于在渲染前精确预测文本高度,并实现任意形状周围的文本重排。它解决了React Native默认文本布局的矩形约束和性能瓶颈,适合需要杂志式布局、流式AI聊天或优化列表性能的React Native开发者。

核心功能
- 任意形状周围文本重排
- 渲染前精确文本高度预测
- 极速逐帧布局计算(~0.0002ms)
- 流式AI聊天增量测量
- 兼容React Native无障碍、动态字体和Expo Web
快速开始
- 运行命令 npx expo install expo-pretext 安装库。
- 在React Native组件中导入hook如 useTextHeight 或组件如 BalancedText。
- 调用hook或组件传入文本和样式,获取布局信息用于渲染。
界面预览

与其他方案对比
| 对比项 | expo-pretext | 同类方案 |
|---|---|---|
| 文本布局能力 | 支持任意形状周围文本重排、精确高度预测和逐帧布局计算 | React Native默认只支持矩形布局,react-native-skia的Paragraph API也仅限矩形 |
| 布局计算速度 | 纯JS布局计算约0.0002ms,可每帧多次调用,适合动画和手势 | 原生布局需要桥接,速度较慢,无法频繁重算 |
适合谁用
- 开发聊天应用并需要流式文本测量的React Native工程师
- 创建杂志或游戏界面并需要形状周围文本重排的UI开发者
- 使用FlashList优化列表性能并需要精确高度的移动应用开发者
下载与版本
当前最新版本为 v1.1.0,发布于 2026-04-18。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/JubaKitiashvili/expo-pretext