tldraw 3.10.0版本发布：全面支持富文本编辑功能

tldraw是一个开源的数字白板和绘图工具，它提供了简洁直观的界面和强大的绘图功能。作为一个基于Web的工具，tldraw特别适合用于协作绘图、头脑风暴和快速草图设计。它的SDK允许开发者将绘图功能集成到自己的应用中。

富文本编辑功能成为核心特性

在3.10.0版本中，tldraw迎来了一个重大更新——将富文本编辑作为编辑器的一等公民。经过深入评估，开发团队选择了TipTap作为默认的富文本编辑解决方案。TipTap是一个基于ProseMirror构建的现代化富文本编辑器框架，以其灵活性和可扩展性著称。

技术实现细节

tldraw集成了TipTap的StarterKit扩展包，这个扩展提供了基本的富文本编辑功能，包括：

• 文本样式（粗体、斜体、下划线等）
• 标题和段落格式
• 列表（有序和无序）
• 引用块
• 代码块

此外，团队还添加了一些自定义扩展来优化用户体验，使得文本编辑更加流畅自然。这些扩展可能包括特殊的快捷键处理、与其他形状的交互优化等。

开发者自定义选项

考虑到不同项目的需求差异，tldraw提供了textOptions属性，允许开发者：

• 添加或移除TipTap扩展
• 自定义现有扩展的行为
• 完全替换默认的富文本编辑配置

这种设计既保证了开箱即用的便利性，又为高级用户提供了充分的定制空间。

重大变更说明

随着富文本功能的引入，API发生了一个重要变化：

• 大多数形状的text属性已被移除，取而代之的是richText属性
• 设置文本时，需要使用toRichText()函数将普通字符串转换为富文本格式
• 获取文本内容时，需要使用renderPlaintextFromRichText()函数将富文本转换为纯文本

这个变更虽然需要开发者进行一些适配工作，但为应用带来了更强大的文本处理能力。

性能优化与稳定性改进

3.10.0版本还包含多项性能优化和稳定性修复：

1. 文件处理方面：

• 修复了.tldr文件中嵌入的base64资源在重新加载时无法正确恢复的问题
• 改进了文件上传失败时的用户体验，现在会显示明确的错误图标
• 修复了Safari浏览器中从计算机粘贴文件的问题

2. 协作功能增强：

• 公开了usePeerIds和usePresence协作钩子，方便开发者构建更复杂的协作功能
• 为协作组件添加了userId参数，支持更精细的权限控制

3. 核心功能修复：

• 解决了文档加载时的性能回退问题
• 修复了Firefox浏览器中foreignObjects的导出和样式嵌入问题
• 改进了reparentShapes()函数，确保形状在重新父级化时保持原有顺序
• 修复了特定情况下的调整大小问题

国际化与输入法支持

团队特别关注了国际化用户体验：

• 修复了Chrome浏览器中使用输入法时按Enter键可能导致文本重复的问题
• 改进了各种输入法环境下的文本编辑体验

开发者生态

这一版本由来自全球的多位贡献者共同完成，包括核心团队成员和社区开发者。这种开放的开发模式确保了tldraw能够快速响应各种使用场景的需求，同时也证明了项目的活跃度和社区支持力度。

升级建议

对于现有项目，升级到3.10.0版本时需要注意：

1. 仔细检查所有使用text属性的地方，按照上述变更说明进行适配
2. 测试富文本功能是否符合项目需求，必要时通过textOptions进行定制
3. 验证协作功能是否正常工作，特别是如果使用了新公开的协作钩子

对于新项目，3.10.0版本提供了更完善的文本处理能力和更稳定的协作基础，是开始使用tldraw的良好起点。

tldraw 3.10.0通过引入富文本编辑功能，进一步巩固了其作为专业绘图工具的地位，同时也展示了项目团队对开发者体验和终端用户需求的持续关注。