跳至正文

文档对应 SoEditor 1.2.1

文本与列表

选中文本后使用粗体、斜体和链接等行内工具;段落、标题、引用和列表作用于相应块。对齐与缩进通过命令完成,撤销恢复为一个编辑历史步骤。

code 是行内语义,pre 用于保留换行与空格的文本。避免为了视觉样式把所有内容转换为标题,或用连续空格模拟缩进。

已有 class、属性与 CMS 标记应保留;更改块类型后请检查 HTML 是否仍符合宿主样式要求。

最小内容与预期行为

ts
export async function editArticle(host: HTMLElement) {
    return createClassicEditor(host, {
        data: '<h2>Article</h2><p class="intro">Select text to format it.</p><ul><li>First item</li></ul>',
    });
}

选择文字后切换加粗,或把光标放进列表项后改变列表样式;通过撤销恢复前一状态,并读取 getData() 验证 HTML。

常见错误

工具栏会根据选区启用或禁用命令。外部按钮应先恢复编辑器焦点,再执行公开命令;不要从 DOM 反向拼装正文。

下一步

运行示例 · 配置参考 · 常见问题

面向网站 CMS 的 HTML 编辑器 · MIT