Summernote富文本如何上传文件

说起富文本编辑器，Summernote 算是不少开发者手里的常备工具——轻量、易用、功能也够全。但在实际项目中，大家最常碰到的需求之一就是上传文件：怎么让编辑器支持用户上传文档、图片，并在内容里正确显示出来？下面就把这流程拆开聊聊。

准备工作

先把该准备的都备齐。确保项目中已引入 Summernote 的核心库和样式文件，以及它依赖的 jQuery、Bootstrap（按需）。典型做法是在 HTML 页面里这样加载：

添加文件上传功能

1. 准备文件选择器

在编辑器附近放置一个文件输入框，用来触发文件选择。比如在工具条下方或页面任意位置，加上这样一句：

2. 编写上传逻辑

通过 Ja vaScript 监听文件选择事件，然后用 FormData 组装文件并通过 AJAX 提交到后端。这里给一个最直接的实现参考：

document.getElementById('file-upload').addEventListener('change', function(event) {
    var file = event.target.files[0];
    var formData = new FormData();
    formData.append('file', file);
    var xhr = new XMLHttpRequest();
    xhr.open('POST', 'your-upload-url', true);
    xhr.onreadystatechange = function() {
        if (xhr.readyState === 4 && xhr.status === 200) {
            console.log('File uploaded successfully');
        }
    };
    xhr.send(formData);
});

3. 在富文本中展示上传的文件

文件上传成功后，后端通常会返回一个 URL 或文件名。接下来需要把结果插入到 Summernote 的内容区。比如上传的是文档，可以插入一个可点击的链接：

// 假设后端返回了文件名和链接
var fileName = 'example.txt';
var fileUrl = 'your-file-url';
// 使用 Summernote 的 API 插入链接
$('#summernote').summernote('editor.insertText', '' + fileName + '');

注意事项

服务器端处理

别忘了后端得能接得住上传请求。需要配置对应的路由、文件存储路径以及必要的响应处理。否则前端写得再漂亮也白搭。

安全性

文件上传是安全漏洞的高发区。建议对上传文件做严格的格式和大小限制，同时校验 MIME 类型，避免恶意脚本或危险文件混进来。搞个白名单过滤更靠谱。