Unlayer Image Editor 集成说明
概述
Unlayer Image Editor 是一款可独立嵌入的图片编辑器，支持使用纯 JavaScript 或 React 进行集成。它区别于 Unlayer 构建器（builder）内部自带的图片编辑器——后者通过 unlayer.init() 进行配置。该独立编辑器及其所有手动编辑工具均为免费，可选的 AI Assistant 为付费功能。
选择集成方式
根据不同需求选择对应的集成文档：纯 JavaScript 嵌入、加载器（loader）、回调或实例生命周期，参见 references/javascript.md；使用 @unlayer/react-image-editor 的 React 或 Next.js 集成，参见 references/react.md；工具、图标、dock、主题、本地化或 AI Assistant 相关配置，参见 references/configuration.md。若要配置从构建器内图片打开的图片编辑器，应改用 unlayer-config。
核心工作流
接受图片 URL 或 base64 data URL；尽可能挂载到宽度至少 1024px、高度至少 700px 的容器中；处理 onSave 并上传返回的 blob，使用 dataUrl 用于预览或内联显示；将 onLoadError 与脚本或生命周期失败分开处理；关闭前检查 hasChanges()，编辑器不再使用时调用 destroy()。
注意事项
JavaScript 加载器使用 https://cdn.unlayer.com/image-editor/embed.js；React 使用 @unlayer/react-image-editor，不要用 react-email-editor 替代；在固定版本前先用 npm view @unlayer/react-image-editor version 确认包版本；调用实例方法前需等待 createEditor() 返回的 Promise；AI 功能要求提供 projectId，手动工具则不需要付费功能；远程图片 URL 需要 CORS 访问权限，可使用 onLoadError 处理抓取、解码或 404 失败；需区分 dataUrl 与 blob 的用途：前者用于预览，后者用于上传。
官方资源
Image Editor 概览、Image Editor 快速上手、Image Editor API 参考、React Image Editor、GitHub 上的 React wrapper。