DIV CSS 佈局教程網

SinaEditor 使用筆記:嵌入、圖片上傳與格式限制
編輯:JQuery特效代碼     

SinaEditor 是一個輕量的所見即得編輯器,用 iframe 方式嵌入頁面,設定簡單。以下記錄實際使用時的幾個要點。

一、準備檔案

先下載 SinaEditor 並放進專案目錄,核心檔案是 editor.htm。

二、在 JSP 頁面中嵌入

<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 修補都比較有保障。

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