React 无限画布 SDK:一行代码起一块白板,协作可自托管(tldraw)

发布于

tldraw

APP构建

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 无限画布 SDK

tldraw 怎么接进 React:装包到持久化三步

  1. npm install tldraw,在 React 里渲染 <Tldraw />,先跑通「能画能存」
  2. 需要持久化就接官方的 sync 文档(可自托管),或自己存 shape 快照
  3. 要做成产品再加自定义形状与工具,参照 Examples 里的对应示例改

免费开发、生产要 license:最容易踩的坑

  • 许可证不是常见开源协议:README 写明 SDK 可以免费用于开发,但生产环境需要 license key(定价见 tldraw.dev/pricing)——先确认预算再选型,这是最容易踩的坑
  • 名称与 Logo 是商标,按它的商标指南使用,不能随便拿来做自己的产品名
  • 只能嵌 React 项目,Vue/原生 JS 要自己想办法(工作量大)
  • 定制越深越依赖它的内部模型(shape/binding/store),大版本升级要跟着改
  • 默认 UI 偏「产品化白板」,想做成专业绘图工具要覆盖不少默认行为
  • 移动端触控体验不如原生应用,复杂手势场景需要额外调
  • 文档更新快,网上老教程的 API 常对不上当前版本

要 GPL 可商用或开箱能用:DGM.js 与白板工具怎么选

小提示:先做一个「只读画布」的 PoC 再决定投入——把 tldraw 渲染出来、加载一份 shape 快照、试着禁用编辑,半天就能确认它能不能满足你的交互约束;比先读完整文档再动手省时间,也能提前撞到 license key 这件事。

地址:https://github.com/tldraw/tldraw

开发工具里其它被搜得最多的工具