编辑器能够显示一张图片,不代表它已经替你的应用保存了图片文件。完整产品还需要资源存储、字体和服务端能力。本章说明它们分别接在哪里。
图片:内容引用与文件一起保存
插入图片通常有两个步骤:先把图片交给存储服务,得到稳定的资源 ID;再通过内容命令把这个 ID 写进文档。显示时,由资源解析服务把 ID 转成可用的图片地址或字节。
临时 Blob URL 适合当前会话预览,不能作为长期存储地址。保存文档时要同时保留资源身份和图片字节。异步上传结束后,也要确认原来的插入目标仍然有效。
Classic 可以通过 media 配置存储接收端(sink)和资源解析端(resolver),通过 host 提供文件选择等宿主能力。自建工作区则向 View 的 mediaResolver 提供解析服务,并给文件转换使用匹配的媒体服务。
字体:加载完成后更新排版
字体会影响文字宽度、换行和页数。加载字体后,使用已挂载 View 的字体度量刷新能力更新布局;只修改界面 CSS 字体并不足以更新文档分页。
Classic 可选用 web font library。应用负责字体文件的获取、许可和加载失败处理。需要导出时,也应让转换流程获得相同的字体资源。
按需求增加产品能力
| 需要的能力 | 接入位置 | 应用还要准备什么 |
|---|---|---|
| Word 与 DOCX | Word 预设、模型转换与文件服务 | 存储目标、转换提示、媒体资源 |
| 审阅、表单等专业界面 | 可选 @quirekit/classic-pro | 对应包和功能配置 |
| 协作 | 协作扩展与选定的文档协议 | 后端、用户身份、权限和冲突策略 |
| AI | AI 能力包与功能声明 | 模型连接、权限与产品交互 |
| 功能区、菜单、侧栏 | 自己的 UI 或 Classic 插件 | 布局和业务动作 |
这些能力按需安装,各有自己的依赖和许可。不要把完整示例中已经启用的功能当成全部框架能力,也不要假定创建 Editor 就会自动连接账户、存储或协作后端。
自己的工作区从工程参考继续扩展;复用产品界面从 Classic 配置与产品插件开始。