SinaEditor 是一個輕量的所見即得編輯器,用 iframe 方式嵌入頁面,設定簡單。以下記錄實際使用時的幾個要點。
先下載 SinaEditor 並放進專案目錄,核心檔案是 editor.htm。
<textarea name="problemBody" id="content" style="display:none;"></textarea>
<iframe src="<%=request.getContextPath() %>/edit/editor.htm?id=content&ReadCookie=0"
frameBorder="0" marginHeight="0" marginWidth="0"
scrolling="No" width="621" height="457"></iframe>
這裡有兩個關鍵:src 要指向下載回來的 editor.htm 實際路徑;而 id=content 這裡的 content 必須與 textarea 的 id 完全一致,編輯器靠這個參數找到要接管的欄位。`ReadCookie=0` 則是關閉讀取 cookie 的行為。
下載包裡的 img.htm 負責圖片上傳,attach.htm 負責附件上傳,兩者用法基本相同,都可以視為「上傳檔案」。
img.htm 中的上傳驗證大致如下:
function chk_imgpath () {
if($('radio1').checked == true){
// 使用網路圖片網址
if($("imgpath").value == "https://" || $("imgpath").value == "") {
window.close();
return;
}
LoadIMG($("imgpath").value);
}else{
// 上傳本機檔案
if($("file1").value == "") {
alert("請選擇上傳圖片文件!");
return;
}
var filepath = j("#file1").val();
var filetype = filepath.substring(filepath.lastIndexOf('.'));
var regu = ".gif.jpg.png.jpge.GIF.JPG.PNG";
if (regu.indexOf(filetype) == -1) {
alert('只允許上傳 .gif .jpg .png 類型文件!');
return;
}
j.ajaxFileUpload({
type: 'POST',
secureuri: false,
fileElementId: 'file1',
url: '/ask/fileUpload?type=img',
dataType: 'String',
success: function(data){
j("#imgpath").attr("value", data);
j("#radio1").attr("checked", "true");
chk_imgpath();
$('divProcessing').style.display = '';
},
error: function(data){
alert('文件上傳失敗');
}
});
}
}
流程是:先看使用者選的是「網路網址」還是「本機檔案」;若是檔案則檢查有沒有選、副檔名是否在白名單,接著用 ajaxFileUpload 這個插件以非同步方式上傳;成功後把回傳的網址寫回輸入框並呼叫 LoadIMG() 插入編輯器。
檔案上傳無法用一般的 $.ajax() 實作(HTML5 之前),所以這裡用了 ajaxFileUpload 插件,它其實是透過隱藏 iframe 模擬出非同步上傳的效果。
最後要自己實作 /ask/fileUpload 這個端點,接收檔案、存到伺服器或 CDN,再把可存取的網址當作純文字回傳。
副檔名檢查要用 server 端再驗一次。 上面那段只檢查檔名,有心人士把 .aspx 改名成 .jpg 就能上傳;後端必須驗證實際的 MIME 型別與檔案內容,並把上傳目錄設為不可執行。
上傳大小限制。 除了伺服器設定(如 web.config 的 maxRequestLength),編輯器端也該對圖片尺寸做壓縮,避免使用者上傳幾 MB 的原始照片拖慢頁面。
新專案的選擇。 SinaEditor 已多年未更新,若今天要選所見即得編輯器,TinyMCE、CKEditor 5 或 Quill 都是更合適的選擇,維護與 XSS 修補都比較有保障。