網路上 Summernote 上傳圖片的範例不少,但很多複製下來會出錯。以下這份把已知的問題都修掉了,前端部分可以直接跑。
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
<!DOCTYPE html >
<html>
<head>
<script src="//code.jquery.com/jquery-1.9.1.min.js"></script>
<link href="//netdna.bootstrapcdn.com/bootstrap/3.0.1/css/bootstrap.min.css" rel="stylesheet" type="text/css">
<script src="//netdna.bootstrapcdn.com/bootstrap/3.0.1/js/bootstrap.min.js"></script>
<link href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.min.css" rel="stylesheet" type="text/css"><!-- 必須 -->
<link href="summernote-master/dist/summernote.css" rel="stylesheet" type="text/css"><!-- 必須 -->
<script src="summernote-master/dist/summernote.js"></script><!-- 必須 -->
<script src="summernote-master/lang/summernote-zh-CN.js"></script>
<title>bootstrap-markdown</title>
<style>
.note-alarm {
float: right;
margin-top: 10px;
margin-right: 10px;
}
</style>
</head>
<body>
<div id="summernote"></div>
<script type="text/javascript">
$(document).ready(function () {
$('#summernote').summernote({
height: 300,
lang: 'zh-CN', // 預設為 'en-US'
focus: true,
toolbar: [
['style', ['bold', 'italic', 'underline', 'clear']],
['fontsize', ['fontsize']],
['color', ['color']],
['para', ['ul', 'ol', 'paragraph']],
['height', ['height']],
['insert', ['picture', 'video']]
],
onImageUpload: function (files, editor, $editable) {
sendFile(files[0], editor, $editable);
}
});
});
function sendFile(file, editor, $editable) {
$(".note-toolbar.btn-toolbar").append('正在上傳圖片');
var filename = false;
try {
filename = file['name'];
} catch (e) {
filename = false;
}
if (!filename) {
$(".note-alarm").remove();
}
// 以上可避免在編輯器內拖曳圖片時觸發第二次上傳所造成的錯誤提示
var ext = filename.substr(filename.lastIndexOf(".")).toUpperCase();
var timestamp = new Date().getTime();
// name 是自訂的檔名,aid 是我自行加在元素上的屬性,用來區分使用者
var name = timestamp + "_" + $("#summernote").attr('aid') + ext;
var data = new FormData();
data.append("file", file);
data.append("key", name);
data.append("token", $("#summernote").attr('token'));
$.ajax({
data: data,
type: "POST",
url: "/summernote/fileupload", // 上傳端點,回傳圖片可存取路徑
cache: false,
contentType: false,
processData: false,
success: function (data) {
// 把圖片插入編輯器
$('#summernote').summernote('editor.insertImage', data);
$(".note-alarm").html("上傳成功,請等待加載");
setTimeout(function () { $(".note-alarm").remove(); }, 3000);
},
error: function () {
$(".note-alarm").html("上傳失敗");
setTimeout(function () { $(".note-alarm").remove(); }, 3000);
}
});
}
</script>
</body>
</html>
路徑寫死:多數流傳的版本在 success 裡寫死了 https://res.cloudinary.com/...butterfly.jpg,所以不管上傳什麼都顯示同一張圖。上面已改為使用後端回傳的 data。
dataType 設定不當:上傳檔案時 FormData 已經是 multipart,加上 contentType: false 與 processData: false 讓 jQuery 不要自行加工,才是正確組合。
拖曳會觸發兩次上傳:把圖片直接拖進編輯框時,部分版本會同時觸發 drop 與 onImageUpload,導致重複上傳。範例用檔名是否存在來提前退出,是權宜之計;更穩妥的做法是加上防重的旗標。
token 放在 DOM 屬性上並由前端送出,只能攔一般使用者,不能視為真正的權限控制。上傳端點仍必須在後端驗證身分、限制檔案大小與型別,並以伺服器產生的檔名存檔。