萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

SinaEditor 富文本編輯器集成指南:從下載到圖片上傳完整流程

集成步驟概覽

  1. 下載 SinaEditor 源碼包
  2. 部署編輯器靜態資源 (JS/CSS/圖片)
  3. JSP 頁面嵌入 iframe 載入編輯器
  4. 實現圖片/附件上傳後端接口
  5. 前端配置上傳參數與回調處理

核心代碼實現

1. 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>

關鍵點:id=content 必須與 textarea id 一致,編輯器會自動同步內容到該 textarea。

2. 圖片上傳前端邏輯 (img.htm 片段)


function chk_imgpath() {
  if ($('radio1').checked) { // 外部圖片 URL 模式
    const url = $('imgpath').value;
    if (url === 'https://' || url === '') { window.close(); return; }
    LoadIMG(url);
  } else { // 本地上傳模式
    const fileInput = $('file1');
    if (!fileInput.value) { alert('請選擇上傳圖片文件!'); return; }
    
    // 文件類型驗證
    const filepath = fileInput.value;
    const filetype = filepath.substring(filepath.lastIndexOf('.')).toLowerCase();
    const allowed = ['.gif', '.jpg', '.png', '.jpeg'];
    if (!allowed.includes(filetype)) {
      alert('只允許上傳 .gif/.jpg/.png/.jpeg 類型文件!');
      return;
    }
    
    // AJAX 文件上傳 (需 jQuery Form Plugin 或原生 FormData)
    const form = $('#form1');
    $.ajaxFileUpload({
      type: 'POST',
      secureuri: false,
      fileElementId: 'file1',
      url: '/ask/fileUpload?type=img',
      dataType: 'json', // 建議返回 JSON
      success: function(data) {
        // 後端返回圖片 URL
        $('#imgpath').val(data.url);
        $('#radio1').prop('checked', true);
        chk_imgpath(); // 遞歸調用加載圖片
        $('divProcessing').show();
      },
      error: function() {
        alert('文件上傳失敗');
      }
    });
  }
}

3. 後端上傳接口設計 (Spring MVC 示例)


@RestController
@RequestMapping("/ask")
public class UploadController {
  
  @PostMapping("/fileUpload")
  public ResponseEntity upload(@RequestParam("file1") MultipartFile file,
                                  @RequestParam("type") String type) {
    // 1. 文件驗證 (大小、類型、內容掃描)
    // 2. 存儲 (本地/對象存儲 OSS/S3/MinIO)
    // 3. 生成訪問 URL
    // 4. 返回標準格式
    return ResponseEntity.ok(Map.of("url", "https://cdn.example.com/img/xxx.jpg"));
  }
}

attach.htm 附件上傳同理

僅修改允許類型 (如 .pdf/.doc/.xls/.zip) 和存儲路徑,前端邏輯完全復用。

常見問題與優化

  • iframe 同源策略:編輯器頁面必須與主頁同域,否則無法通過 parent.document.getElementById('content') 同步數據
  • XSS 防護:後端需過濾 HTML 標籤 (如 Jsoup),前端輸出時轉義
  • 大文件分片上傳:大文件採用分片 + 斷點續傳 (WebUploader/Uppy)
  • 圖片壓縮:前端 Canvas 壓縮後再上傳,節省帶寬
  • 現代替代方案:TinyMCE、CKEditor、Quill、WangEditor (國產)、Tipi

遷移建議

SinaEditor 早期產品,維護狀態不明。新項目強烈建議選用活躍維護的現代編輯器,支持 React/Vue/Angular 組件化集成、TypeScript、協同編輯、Markdown 模式等現代特性。

copyright © 萬盛學電腦網 all rights reserved