
tldraw
做过白板/画布类产品的人都知道:无限画布、吸附、箭头绑定、多人光标这些基础能力,自己写至少要几个月。tldraw 把这些打包成了一个 React SDK——<Tldraw /> 一行就是一块完整白板,也能只借它的底层自己造形状。
一行代码起一块白板:tldraw 自带哪些能力
- 完整无限画布引擎:开箱有便签、几何图形、箭头、富文本、图片视频、吸附对齐、边缘滚动画布、导出图片
- 压感绘图:支持数位笔的压感笔迹
- 自定义形状/工具/绑定/UI:
custom shapes、tools、bindings、ui components、副作用与事件钩子都能接 - 运行时 API:
Editor API可以在代码里驱动画布(选中、变换、创建形状) - 多人协作:
@tldraw/sync提供可自托管的实时协作 - DOM 渲染:画布上的形状是真实 DOM,所以能嵌 YouTube、Figma、GitHub 之类的网页
- AI 集成:官方提供给 LLM 用的画布原语(
tldraw.dev/docs/ai) - 有文档、Examples、Starter kits 三条入手路径
一行 <Tldraw /> 出来就是完整白板,工具栏、右键菜单都自带:

tldraw 怎么接进 React:装包到持久化三步
npm install tldraw,在 React 里渲染<Tldraw />,先跑通「能画能存」- 需要持久化就接官方的 sync 文档(可自托管),或自己存 shape 快照
- 要做成产品再加自定义形状与工具,参照 Examples 里的对应示例改
免费开发、生产要 license:最容易踩的坑
- 许可证不是常见开源协议:README 写明 SDK 可以免费用于开发,但生产环境需要 license key(定价见 tldraw.dev/pricing)——先确认预算再选型,这是最容易踩的坑
- 名称与 Logo 是商标,按它的商标指南使用,不能随便拿来做自己的产品名
- 只能嵌 React 项目,Vue/原生 JS 要自己想办法(工作量大)
- 定制越深越依赖它的内部模型(shape/binding/store),大版本升级要跟着改
- 默认 UI 偏「产品化白板」,想做成专业绘图工具要覆盖不少默认行为
- 移动端触控体验不如原生应用,复杂手势场景需要额外调
- 文档更新快,网上老教程的 API 常对不上当前版本
要 GPL 可商用或开箱能用:DGM.js 与白板工具怎么选
- 想要 GPL 系、可自由商用的画布:DGM.js
- 在线白板直接拿来用、不写代码:iCraft
- 要做文档编辑器(块模型):BlockNote
- 同一套 React 思路搬到手机端:React Native + Expo 跨端
- 只要画流程图导出图片:draw.io 桌面版
小提示:先做一个「只读画布」的 PoC 再决定投入——把 tldraw 渲染出来、加载一份 shape 快照、试着禁用编辑,半天就能确认它能不能满足你的交互约束;比先读完整文档再动手省时间,也能提前撞到 license key 这件事。
地址:https://github.com/tldraw/tldraw