第22章 第 22 章:drawDB 的工作原理
第 22 章:drawDB 的工作原理 理解 drawDB 的 React 架构、SVG 画布、浏览器存储、SQL 与 DBML 导入、导出、分享及本地化功能。 开源版 drawDB 编辑器是一个基于 Vite 构建的 React 应用程序。它使用 React Context 提供者来管理编辑器状态,而非依赖独立的 Redux 或 Zustand 存储。
编辑器画布 画布是一个由指针事件驱动的 SVG 表面。表格、主题区域以及大部分注释内容通过 SVG foreignObject 元素渲染。关系线则是根据相连字段的位置和尺寸计算得出的 SVG 路径。
这种结构允许 drawDB 将熟悉的 HTML 控件与可缩放、可平移的图表表面结合在一起。
浏览器持久化 开源版图表和自定义模板通过 Dexie 存储在 IndexedDB 中。编辑器偏好设置、自定义数据类型别名和版本缓存信息则保存在本地存储中。
由于这些数据绑定于特定的浏览器配置文件,建议在清除站点数据、重置浏览器或更换设备前导出重要图表。
分享功能 开源版的“分享”操作会将当前图表的 JSON 发布为一个私有的 GitHub Gist。分享链接会加载该快照,并为接收者创建一个本地副本。这不是实时同步通道。
导入功能 drawDB 支持导入以下内容:
* drawDB JSON 和 DDB 文件 * DBML * 适用于 MySQL、PostgreSQL、SQLite、MariaDB、Microsoft SQL Server 和 Oracle SQL 的 SQL 语句
SQL 源代码会被解析为抽象语法树(AST),随后转换为 drawDB 的表格、字段、索引、枚举、类型和关系(前提是源代码方言提供了足够的信息)。
导出功能 编辑器支持将图表导出为以下格式:
* SQL * PNG、JPEG、SVG 和 PDF * drawDB JSON * DBML * Mermaid * Markdown
SQL 输出使用针对不同数据库方言的生成器。图像和文档格式则使用渲染后的图表以及专用的序列化或导出库处理。
国际化 界面字符串位于 drawDB 仓库的 src/i18n/locales 目录下。添加新语言需要执行以下步骤:
* 基于 en.js 创建翻译后的语言包文件。 * 在 src/i18n/i18n.js 中导入该语言包。 * 将其添加到语言列表中。 * 在 i18next 资源映射中注册该语言。
专业版架构 drawDB Pro 在核心编辑器之上集成了认证、团队、云端图表存储、权限管理、计费、AI 工具及实时协作功能。这些服务与上述描述的浏览器本地开源版持久化及 Gist 分享机制是相互独立的。
探索源码:浏览编辑器组件、上下文、导入器、导出器及本地化文件。 阅读分享指南:了解开源版分享链接具体发布了什么内容,以及接收者如何加载它。 在 GitHub 上编辑:最后更新于 键盘快捷键:完整的 drawDB 保存、导入、剪贴板、编辑、画布、缩放、视图及文档快捷键参考。