TinyMCE 要正常顯示圖片,最基本的前提是圖片網址能指向一個實際可存取的位置。而這其實只是普通 HTML 富文本編輯器的基本功能——使用者選一張本機的圖片,它就該上傳並在編輯區裡顯示出來。本文要做的就是替 TinyMCE 補上這塊。
用 Ajax 做非同步上傳,再把回傳的網址填回圖片對話框。之所以選 Ajax 而非傳統表單提交,是因為後者會導致整個編輯器重新載入,使用者正在編的內容就飛了。
另一個關鍵認知是:TinyMCE 的架構類似 Firefox,允許開發者為它撰寫符合自身需求的插件。因此我們不必改動核心,只要針對 advimage 這個外掛稍作修改即可。
具體位置是 TinyMCE 目錄下的:
tinymce/jscripts/tiny_mce/plugins/advimage/image.htm
在 image.htm 裡新增一個上傳函式,它會把表單非同步送出,成功後把回傳路徑填進 #src 並觸發預覽:
<script type="text/javascript">
function AjaxUploadPic() {
if ($("#flUpload").val() == "") {
alert("請選擇一個圖片文件,再點擊上傳。");
return;
}
$('#myForm').ajaxSubmit({
beforeSubmit: function() {
// 這裡可顯示 loading 提示
},
success: function(html, status) {
var result = html.replace("<PRE>", "").replace("</PRE>", "");
// 若回傳內容含有「格式」字樣,視為後端的錯誤訊息
if (html.indexOf("格式") > 0) {
alert(result);
return;
}
$("#src").val(result);
ImageDialog.showPreviewImage($("#src").val());
}
});
}
</script>
這裡的 ImageDialog.showPreviewImage() 是 TinyMCE 原本的預覽函式,直接沿用就能讓右側預覽區立刻更新,使用者上傳後不必關掉再開一次對話框確認結果。
檔案上傳的 <form> 有三個屬性缺一不可,這是最容易出錯的地方:
<form id="myForm" method="post"
enctype="multipart/form-data"
action="你的上傳處理位址">
<input type="file" id="flUpload" name="file" />
</form>
enctype="multipart/form-data" 少了檔案不會被送出;name 屬性少了後端在 Request.Files 裡找不到對應項(注意:只給 id 是不夠的,file input 一定要 name)。
程式截圖:
前端只負責傳,存檔與驗證在後端。一個最小可用的 ashx:
public class PicUploadHander : IHttpHandler
{
private static readonly string[] Exts = { ".jpg", ".jpeg", ".png", ".gif" };
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "text/plain";
if (context.Request.Files.Count == 0)
{
context.Response.Write("格式錯誤:未收到檔案");
return;
}
var file = context.Request.Files[0];
var ext = Path.GetExtension(file.FileName).ToLowerInvariant();
if (!Exts.Contains(ext))
{
context.Response.Write("格式錯誤:僅支援 jpg / png / gif");
return;
}
if (file.ContentLength > 2 * 1024 * 1024)
{
context.Response.Write("格式錯誤:檔案不得超過 2MB");
return;
}
// 用 GUID 命名,避免檔名衝突與路徑跳脫
var relative = "/upload/images/" + Guid.NewGuid().ToString("N") + ext;
var physical = context.Server.MapPath("~" + relative);
file.SaveAs(physical);
context.Response.Write(relative); // 回傳相對路徑供 TinyMCE 使用
}
public bool IsReusable { get { return false; } }
}
注意範例中回傳的是相對路徑而非絕對 URL。若回傳 https://localhost:8080/... 這種含網域的路徑,部署後換了網域或走 HTTPS,內容裡就會出現失效連結甚至混合內容警告。
用「回傳字串裡有沒有『格式』兩個字」來判斷錯誤是很脆弱的做法。只要使用者上傳的檔名或後端訊息裡恰好出現這兩個字就會誤判。應改為讓後端回傳 JSON,前端明確檢查 res.ok。
TinyMCE 版本相容性。本文的 tinymce/jscripts/tiny_mce/ 目錄結構屬於 TinyMCE 3.x。4.x 之後目錄大改,圖片對話框也從 image.htm 變成 plugin.js 內的視窗設定,做法完全不同。TinyMCE 5/6 則有官方文件說明的 file_picker_callback /file_picker_types: 'file' 機制,不必再手改外掛檔案——這才是現在應該採用的方式。
修改核心外掛檔案的代價。直接改 advimage 意味著每次升級 TinyMCE 都要重新改一次。可行的替代方案是把新功能寫成獨立外掛註冊,或以事件掛鉤方式注入,讓原始檔案保持乾淨。
安全性。富文本編輯器的圖片上傳是常見的攻擊入口。務必做到:副檔名白名單、檢查實際內容型別、限制大小、伺服器端重新產生檔名、儲存目錄禁止執行任何腳本,並要求登入權限——否則等於開放了一個匿名上傳空間。