萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

ASP.NET 整合 HtmlArea 3.0 編輯器:JS 初始化、UpdatePanel 重新綁定、中文語系 UTF-8 設定

HtmlArea 簡介

純 JavaScript + HTML 輕量編輯器,無伺服端相依,理論相容任何後端平台。經實測與 ASP.NET 2.0 + AJAX (UpdatePanel) 完美整合。

安裝步驟

  1. 下載 HtmlArea 3.0,解壓至專案目錄(如 /HtmlArea/)
  2. 中文語系檔修正編碼:lang/gb.js 預設為 ANSI,專案若為 UTF-8(預設),**必須用記事本另存為 UTF-8**,否則中文亂碼

前端引用與初始化

<!-- 引用核心 JS -->
<script type="text/javascript">
  _editor_url = "../HtmlArea/";  // HtmlArea 目錄相對路徑
  _editor_lang = "gb";           // 使用中文語系
</script>
<script type="text/javascript" src="../HtmlArea/htmlarea.js"></script>

<!-- 目標 TextBox,CssClass=htmlarea 為觸發鉤子 -->
<asp:TextBox ID="HtmlArea" CssClass="htmlarea" runat="server" 
    TextMode="MultiLine" Height="200px" Width="100%"></asp:TextBox>

後端註冊啟動腳本(首次載入)

protected void Page_Load(object sender, EventArgs e)
{
    if (!Page.IsPostBack)
    {
        StringBuilder sb = new StringBuilder();
        sb.Append("var editor = null;");
        sb.Append("function initEditor() {");
        sb.AppendFormat("editor = new HTMLArea('{0}');", HtmlArea.ClientID);
        sb.Append("editor.generate();");
        sb.Append("}");
        sb.Append("document.body.onload = initEditor;");
        
        ScriptManager.RegisterStartupScript(this.Page, this.GetType(), 
            "HtmlAreaScript", sb.ToString(), true);
    }
}

UpdatePanel 部分更新後重新初始化

非同步回傳會銷毀編輯器實例,需在回傳後重建:

// 在觸發非同步回傳的事件處理中(如按鈕 Click)
ScriptManager.RegisterStartupScript(this.Page, this.GetType(), 
    "HtmlAreaScript", "initEditor();", true);

常見坑點與解決

現代替代建議

HtmlArea 專案已停止維護(最後版本 2005)。新專案建議:

  • CKEditor 4/5、TinyMCE:成熟、活躍維護、支援現代框架
  • Quill、Slate、TipTap:現代架構、模組化、React/Vue 友善
  • ASP.NET Core 可用 <textarea asp-for="Content" class="ckeditor"> 標籤助手整合
copyright © 萬盛學電腦網 all rights reserved
問題原因解決
中文亂碼gb.js 為 ANSI 編碼另存為 UTF-8
UpdatePanel 後編輯器消失DOM 重建,JS 實例遺失回傳後呼叫 initEditor()
_editor_url 路徑錯誤相對路徑基準為當前頁面用 ResolveUrl("~/HtmlArea/") 或絕對路徑
內容無法取得HtmlArea 同步回 TextBox 需時間提交前呼叫 editor.getHTML() 手動同步