整合指南
在 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