Tsao Editor

整合指南

在 Angular Forms 使用富文字編輯器

Tsao Editor 實作 ControlValueAccessor,讓內容與表單中的值、disabled、validation 與 submit 流程一起運作。

Reactive Forms

匯入 standalone editor component、建立 form control,並以 formControlName 綁定。設定的 output mode 會決定控制項收到 HTML、純文字、Markdown 或 JSON 文件。

editorForm = new FormGroup({
  content: new FormControl('<p>草稿內容</p>', { nonNullable: true }),
});

<tsao-editor formControlName="content" />

共用預設與單一編輯器覆寫

多個編輯器需要共用工具列、色票、表格、上傳或輸出設定時,可以在 application config 使用 provideTsaoEditor;個別 component input 仍能覆寫單一編輯器設定。

應該驗證的表單行為

  • Disabled 狀態跟隨 Angular control
  • 編輯器失去 focus 時回報 touched
  • 外部 control value 可以更新文件
  • 編輯變更參與 validation 與 submit