DIV CSS 佈局教程網

為 TinyMCE 加上本地圖片上傳:修改 advimage 插件實作 Ajax 上傳
編輯:JQuery特效代碼     

TinyMCE 要正常顯示圖片,最基本的前提是圖片網址能指向一個實際可存取的位置。而這其實只是普通 HTML 富文本編輯器的基本功能——使用者選一張本機的圖片,它就該上傳並在編輯區裡顯示出來。本文要做的就是替 TinyMCE 補上這塊。

實現思路

用 Ajax 做非同步上傳,再把回傳的網址填回圖片對話框。之所以選 Ajax 而非傳統表單提交,是因為後者會導致整個編輯器重新載入,使用者正在編的內容就飛了。

另一個關鍵認知是:TinyMCE 的架構類似 Firefox,允許開發者為它撰寫符合自身需求的插件。因此我們不必改動核心,只要針對 advimage 這個外掛稍作修改即可。

具體位置是 TinyMCE 目錄下的:

tinymce/jscripts/tiny_mce/plugins/advimage/image.htm

加入 Ajax 上傳程式碼

在 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 都要重新改一次。可行的替代方案是把新功能寫成獨立外掛註冊,或以事件掛鉤方式注入,讓原始檔案保持乾淨。

安全性。富文本編輯器的圖片上傳是常見的攻擊入口。務必做到:副檔名白名單、檢查實際內容型別、限制大小、伺服器端重新產生檔名、儲存目錄禁止執行任何腳本,並要求登入權限——否則等於開放了一個匿名上傳空間。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved