富文本编辑器中批量上传图片需三步:1. 拦截并缓存file对象,用唯一tempid标记占位;2. 用promise.allsettled并发上传,构建tempid→url映射;3. 用domparser解析html,按tempid精准替换img src。

在富文本编辑器(如 Quill、TinyMCE、WangEditor、UEditor)中插入图片时,通常需要先将本地图片上传到服务器,再把返回的图片 URL 插入编辑器。如果用户一次性粘贴或插入多张图片,就需要异步批量上传,并确保所有上传完成后再提交整个富文本内容(含替换后的图片 URL)。关键在于:控制并发、捕获上传结果、按顺序/逻辑替换 HTML 中的临时图片占位符。
1. 拦截富文本中的本地图片并提取 File 对象
富文本中图片常以 <img src="blob:xxx"> 或 base64 形式存在。需遍历 DOM 找出这些图片,读取其原始文件(需提前保存引用,例如在插入图片时用 editor.insertEmbed() 配合自定义 handler 记录 file)。
若未提前记录,可借助 FileReader 从 base64 反解(不推荐,有性能和尺寸限制),更可靠的方式是:在用户选择图片时就拦截 input[type=file] 或拖拽事件,缓存 FileList,同时用唯一 ID(如 uuid())标记每张图,并在插入编辑器时用该 ID 占位:
-
✅ 推荐做法:编辑器插入时用
<img data-temp-id="img_abc123" src="/placeholder.svg"> -
⚠️ 注意:不要依赖
img.src的 blob URL,它无法直接传给后端;必须持有原始File实例
2. 并发上传图片并维护映射关系
使用 Promise.allSettled() 处理批量上传(比 Promise.all() 更健壮,单个失败不影响整体)。
- 为每个
File构造一个上传 Promise,内部用FormData提交,同时携带临时 ID - 后端返回结构建议:
{ tempId: "img_abc123", url: "https://cdn.example.com/xxx.jpg" } - 上传完成后,生成
Map<tempid finalurl></tempid>用于后续替换
示例片段:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
const uploadPromises = fileList.map(file => {
const tempId = file.tempId || generateId();
const formData = new FormData();
formData.append('image', file);
formData.append('temp_id', tempId);
return fetch('/api/upload/image', {
method: 'POST',
body: formData
})
.then(r => r.json())
.then(data => ({ tempId, url: data.url }));
});
Promise.allSettled(uploadPromises).then(results => {
const urlMap = new Map();
results.forEach(r => {
if (r.status === 'fulfilled') {
urlMap.set(r.value.tempId, r.value.url);
}
});
// ✅ urlMap 就绪,可用于替换
});
3. 替换富文本 HTML 中的临时图片标签
获取编辑器原始 HTML(如 quill.root.innerHTML 或 wangEditor.getHtml()),用 DOMParser 安全解析,遍历所有 <img>,匹配 data-temp-id,替换成真实 URL:
- 避免正则替换 HTML(易出错),务必用原生 DOM 操作
- 替换后保留其他属性(
alt、style等),仅更新src - 若某张图上传失败,可留 placeholder 或移除该
<img>,视业务而定
示例:
const parser = new DOMParser();
const doc = parser.parseFromString(html, 'text/html');
doc.querySelectorAll('img[data-temp-id]').forEach(img => {
const tempId = img.dataset.tempId;
const finalUrl = urlMap.get(tempId);
if (finalUrl) {
img.src = finalUrl;
img.removeAttribute('data-temp-id');
} else {
img.remove(); // 或显示错误提示
}
});
const finalHtml = doc.body.innerHTML;
4. 提交最终富文本内容
此时 finalHtml 已不含临时资源,全是有效外链图片。可安全作为字段提交给后端接口:
- POST 到文章创建/更新接口,如
/api/articles - 请求体中传
{ title: "...", content: finalHtml, ... } - 后端无需再处理图片,专注业务逻辑即可
额外建议:
- 上传前校验图片类型/大小,前端给出友好提示
- 加 loading 状态和进度条(尤其图片多时),提升体验
- 失败重试可封装在单个 Promise 内(如用
async/await + for...of + try/catch)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










