5

在我的应用程序中，我有一个特定的对话框来创建内部链接。用户完成填写对话框后，我想以编程方式将生成的链接插入到编辑器中的当前插入符号位置。到目前为止，我一直在使用 SummerNote，这很容易：

editor.summernote('createLink', {
     text: linkTitle,
     url: url
});

在 CKEditor 5 中，我发现这种方法似乎可以满足我的需要：

doc.enqueueChanges(() => {
    editor.data.insertContent(content, doc.selection);
});

我的问题是我不知道如何创建这个“内容”参数。我试图在 HTML 中创建一个链接并将其传递给那里，但这不起作用。

我还尝试创建一个LinkElement实例，但该类似乎不存在于 JS 运行时中（我正在从构建运行 CKEditor，而不是从源代码）。

我不清楚如果不为 CKEditor 编写插件（这在我看来有点矫枉过正），这是否可能实现。

4

1 回答 1

9

1.0.0-beta（2018 年 3 月）之后：

要将一些数据插入编辑器，只需使用“更改块”：

editor.model.change( writer => {
    const insertPosition = editor.model.document.selection.getFirstPosition();
    writer.insertText( linkText, { linkHref: linkUrl }, insertPosition );
} );

wherelinkText和linkUrl是您应该从自定义 UI 中提供的变量。

以上将适用于折叠的选择。链接的文本将插入到插入符号位置。

1.0.0-beta 引入的最大区别是我们writer在调用中提供对象change()，因此您不需要（也不应该）直接使用框架类构造函数。

您也可以editor.model.insertContent按照您提出的类似方式使用：

editor.model.change( writer => {
    const linkedText = writer.createText( linkText, { linkHref: linkUrl } );
    editor.model.insertContent( linkedText, editor.model.document.selection );
} );

如果选择没有折叠，这也将正常工作，还有insertContent一点点（例如，如果选择没有折叠并且在两个段落之间，则选择内容将被删除并合并段落）。

1.0.0-beta 之前

DataController#insertContent()接受模型的DocumentFragment或Node（所以Element或Text-我刚刚注意到 API 文档中缺少此信息）。

不幸的是，现在您需要访问Element' 或Text' 构造函数才能创建它们。这意味着您需要从源代码构建 CKEditor 5，而不是使用现有构建。这并不难，但确实是矫枉过正。因此，我们现在正在努力在现有类中公开 API 的足够部分，以便您可以编写像这样的简单集成代码，而无需将 CKEditor 5 构建到您的应用程序中。

无论如何，如果您要配置 webpack（或简单地 fork 现有构建），您可以编写一个简单的函数来插入链接文本：

import Text from '@ckeditor/ckeditor5-engine/src/model/text';

function insertLink( linkText, linkHref ) {
    const text = new Text( linkText, { linkHref } );

    editor.document.enqueueChanges( () => {
        editor.data.insertContent( text, editor.document.selection );
    } );
}
于 2017-12-04T09:37:22.347 回答