@ domternal/ angular (英语)
用于 永远 丰富的文本编辑器 .
独立编辑器与反应形式和 ngModel 结束
ControlValueAccessor。工具栏、选择菜单、插入菜单和拾取器组件
使用信号和 OnPush 更改检测.
安装
在角应用程序中:
pnpm add @domternal/angular @domternal/core @domternal/theme
目前的建筑以Angular 21.2.20编译. 我们推荐匹配
@angular/core, (中文(简体) ), @angular/forms,以及 @angular/platform-browser 软件包
版本或稍后。 应用程序应使用相同的或较新的编译器,如上所述
内 角库兼容性。 。 。 .
名单中仍然宣称范围更广 >=17.1.0 对等区域; 这不是一个保证
与更古老的Angular释放相兼容.
要求数 @domternal/core >=1.8.0 <2.0.0。对所有安装的1.8.1版本使用
Domternal Free 软件包. 软件包宣布节点.js 22 或以后用于工具; 也跟随
您的角化版本的 节点js要求。 。 。 .
在您的全局样式表中装入主题, 例如 styles.scss数字 :
@use '@domternal/theme/scss';
快开始
此独立组件将文档绑入窗体控件并添加工具栏:
import { Component, signal } from '@angular/core';
import { FormControl, ReactiveFormsModule } from '@angular/forms';
import {
DomternalEditorComponent,
DomternalToolbarComponent,
} from '@domternal/angular';
import { StarterKit, type Editor } from '@domternal/core';
@Component({
selector: 'app-text-editor',
standalone: true,
imports: [ReactiveFormsModule, DomternalEditorComponent, DomternalToolbarComponent],
template: `
@if (editor(); as ed) {
<domternal-toolbar [editor]="ed" />
}
<domternal-editor
[extensions]="extensions"
[formControl]="content"
(editorCreated)="editor.set($event)"
/>
`,
})
export class TextEditorComponent {
readonly editor = signal<Editor | null>(null);
readonly extensions = [StarterKit];
readonly content = new FormControl('<p>Hello from Angular!</p>', { nonNullable: true });
}
编辑拥有其生命周期; editorCreated 为命令提供示例
和兄弟UI组件。 工具栏将控制您的扩展
贡献。 订阅窗体控件 valueChanges 以保存内容.
形式和配置
- 形式值默认为HTML. 使用
outputFormat="json"包含 JSON 内容 用于结构化文档的值。 通话disable()或者说enable()表格上的表格 控制更新可编辑性,一个已禁用的控件启动编辑器 只读。 这个editable输入和控件按变化的顺序决定. - 没有表单,通过 HTML 或 JSON
[content]手柄(contentUpdated), (中文(简体) ), 读取event.editor.getHTML()或者说getJSON()。该部分还揭露htmlContent, (中文(简体) ),jsonContent, (中文(简体) ),isEmpty, (中文(简体) ),isFocused,以及isEditable信号. - 包装包括
Document, (中文(简体) ),Paragraph, (中文(简体) ),Text, (中文(简体) ),BaseKeymap,以及History。 。 。 . 对于另一个撤消管理器, 设置[history]="false"并省略历史 延长,包括 启动器 阿杰的历史。 。 。 . preset="notion"在创建时读取。 这个i18n输入更新 UI 翻译 当替换时,不重创建编辑器或更改其形式值.(contentError)报告无效的初始内容.(contentDiagnostic)报告 标准值;初次报告到达之前editorCreated。见 内容诊断。 。 。 .- 自定义
icons输入包含原始 SVG 。 供应可信,开发者授权的常数.
这个 角向导 包括投入、产出、, 形式行为,以及工具栏、泡泡菜单、浮动菜单、取血器和 名词取色器组件.
办公室粘贴和自定义列表标签
登记册 PasteCleanup 在你的编辑
extensions 以规范支持的 Word 和 Google Docs 剪贴板 HTML 。 没错
无法由包装器启用 。 在1.5.0时, formattingForPaste 允许您的应用程序
选择每个粘贴的保存或适应,而不创建编辑器.
为您添加相应的格式化、 表格和图像扩展名
想要保留。 使用 ListLabels 页:1
支持自定义标记,每个协作作者都有相同的计划.
进一步阅读
- 角向导和组件参考
- 编辑器命令和内容 API
- 他们 财务报告和审定财务报表 本地化为
i18n - 可选剪贴板 HTML 清理