跳到正文
QuireKit
Core 开发文档
Alpha · API 持续演进

接入图片、字体与其他能力

识别编辑器之外的资源服务,为完整产品补齐接入。

编辑器能够显示一张图片,不代表它已经替你的应用保存了图片文件。完整产品还需要资源存储、字体和服务端能力。本章说明它们分别接在哪里。

图片:内容引用与文件一起保存

插入图片通常有两个步骤:先把图片交给存储服务,得到稳定的资源 ID;再通过内容命令把这个 ID 写进文档。显示时,由资源解析服务把 ID 转成可用的图片地址或字节。

临时 Blob URL 适合当前会话预览,不能作为长期存储地址。保存文档时要同时保留资源身份和图片字节。异步上传结束后,也要确认原来的插入目标仍然有效。

Classic 可以通过 media 配置存储接收端(sink)和资源解析端(resolver),通过 host 提供文件选择等宿主能力。自建工作区则向 View 的 mediaResolver 提供解析服务,并给文件转换使用匹配的媒体服务。

字体:加载完成后更新排版

字体会影响文字宽度、换行和页数。加载字体后,使用已挂载 View 的字体度量刷新能力更新布局;只修改界面 CSS 字体并不足以更新文档分页。

Classic 可选用 web font library。应用负责字体文件的获取、许可和加载失败处理。需要导出时,也应让转换流程获得相同的字体资源。

按需求增加产品能力

需要的能力接入位置应用还要准备什么
Word 与 DOCXWord 预设、模型转换与文件服务存储目标、转换提示、媒体资源
审阅、表单等专业界面可选 @quirekit/classic-pro对应包和功能配置
协作协作扩展与选定的文档协议后端、用户身份、权限和冲突策略
AIAI 能力包与功能声明模型连接、权限与产品交互
功能区、菜单、侧栏自己的 UI 或 Classic 插件布局和业务动作

这些能力按需安装,各有自己的依赖和许可。不要把完整示例中已经启用的功能当成全部框架能力,也不要假定创建 Editor 就会自动连接账户、存储或协作后端。

自己的工作区从工程参考继续扩展;复用产品界面从 Classic 配置与产品插件开始。

QuireKitQuireKit · Core、插件与 Classic 文档