错误代码 | CKEditor 5 文档

`accessibility-unknown-keystroke-info-category`

无法在未知类别中添加按键。请使用 addKeystrokeInfoCategory 添加新类别或确保指定类别存在。

参数

categoryId : any: 未知按键类别的 ID。
keystrokes : any: 即将添加的按键定义。

`accessibility-unknown-keystroke-info-group`

无法将按键添加到未知组。

请使用 addKeystrokeInfoGroup 添加新组或确保指定组存在。

参数

groupId : any: 未知按键组的 ID。
categoryId : any: 未知组所属类别的 ID。
keystrokes : any: 即将添加的按键定义。

`ai-commands-config-order-collision`

在 AI 助手功能配置中，两个（或多个）定义设置了相同的 order 值。

了解有关命令定义和组定义的更多信息，这些定义在功能配置中使用

参数

conflictingDefinitions : any: 具有相同 order 值的定义。

`ai-invalid-license-key`

无效的许可证密钥。请联系我们的客户支持，网址为：https://ckeditor.npmjs.net.cn/contact/。

`ai-trial-license-key-reached-limit-changes`

您已超出试用使用限制（原因：达到文档更改限制）。重新启动编辑器。

请联系我们的客户支持以获取完全访问权限，网址为：https://ckeditor.npmjs.net.cn/contact/。

`aiadapter-text-adapter-not-set`

AI 文本适配器插件尚未添加到编辑器中。请使用提供的适配器插件之一（例如，如果您连接到 OpenAI 或 Azure OpenAI 服务，则使用 OpenAITextAdapter）或创建一个自定义适配器。

`aitextadapter-send-request-failed`

向 AI 服务 API 发送请求失败。

`alignment-config-classname-already-defined`

alignment.options 中的一个 className 已被声明过。

参数

option : any: 第一个声明给定 className 的选项。
configuredOptions : any: alignment.options 的内容。

`alignment-config-classnames-are-missing`

至少有一个选项声明 className 后，所有选项都必须定义 className 属性。

参数

configuredOptions : any: alignment.options 的内容。

`alignment-config-name-already-defined`

alignment.options 中的一个 name 已被声明过。每个代表一个对齐选项的 name 都只能设置一次。

参数

option : any: 第一个声明给定 name 的选项。
configuredOptions : any: alignment.options 的内容。

`alignment-config-name-not-recognized`

alignment.options 中的一个 name 未被识别。可用的选项包括：'left'、'right'、'center' 和 'justify'。

参数

option : any: name 属性值未知的选项。

`annotation-invalid-target`

当目标类型无效时抛出的错误。

目标应为以下之一：

DOM 元素或 DOM 元素数组，
或矩形实例，
或 null，
或返回上述内容之一的回调函数。

`annotationcollection-duplicated-item`

注释已存在于集合中。它不能添加多次。

`annotationcollection-not-existing-item`

注释不存在于集合中，无法删除。

`annotationsuis-annotation-mismatch`

注释应始终只属于一个注释 UI 实例。请检查传递给 activate 方法的过滤器。

`annotationsuis-register-already-registered`

已注册具有给定名称的 UI。

`annotationsuis-register-invalid-interface`

注释 UI 插件应实现 AnnotationsUI 接口。

`attachtoform-missing-elementapi-interface`

传递给 attachToForm() 的编辑器必须实现 ElementApi 接口。

`attribute-element-get-elements-with-same-id-no-id`

无法为没有 ID 的属性元素获取具有相同 ID 的元素。

`attribute-operation-attribute-exists`

给定节点已存在具有给定键的属性。

`attribute-operation-range-not-flat`

要更改的范围不平坦。

`attribute-operation-wrong-old-value`

已更改节点的属性值与操作的旧属性值不同。

`batch-constructor-deprecated-string-type`

Batch 构造函数的 type 属性的字符串值已弃用，并将很快被删除。有关更多信息，请参阅 Batch 构造函数 API 文档。

`batch-type-deprecated`

Batch#type 属性已弃用，并将很快被删除。请改用 Batch#isLocal、Batch#isUndoable、Batch#isUndo 和 Batch#isTyping。

`cannot-change-view-tree`

当试图在视图树处于错误状态时对其进行更改时抛出。这可能会导致一些意外的行为以及 DOM 和视图之间的不一致。这可能是由以下原因造成的：

在渲染过程中调用 change 或 forceRender，
在后置处理函数内调用 change 或 forceRender。

`case-change-invalid-license-key`

无效的许可证密钥。请联系我们的客户支持，网址为：https://ckeditor.npmjs.net.cn/contact/。

`case-change-trial-license-key-reached-limit-changes`

您已超出试用使用限制（原因：达到文档更改限制）。重新启动编辑器。

请联系我们的客户支持以获取完全访问权限，网址为：https://ckeditor.npmjs.net.cn/contact/。

`ckbox-access-default-workspace-error`

用户无权访问 ckbox.defaultUploadWorkspaceId 配置中定义的工作区。

`ckbox-fetch-category-http-error`

获取可用类别列表（上传的文件可以与这些类别关联）失败。

`ckbox-image-processing-failed`

图像处理失败。

`ckbox-plugin-image-feature-missing`

CKBox 功能需要加载以下插件之一才能正常工作：

ImageBlock,
ImageInline,
Image（加载 ImageBlock 和 ImageInline）

请确保您的编辑器配置正确。

`ckbox-plugin-missing-token-url`

CKBox 插件需要 config.ckbox.tokenUrl 或 config.cloudServices.tokenUrl 配置。

ClassicEditor.create( document.createElement( 'div' ), {
	ckbox: {
		tokenUrl: "YOUR_TOKEN_URL"
		// ...
	}
	// ...
} );

`ckeditor-duplicated-modules`

当由于 CKEditor 5 的安装、导入或初始化方式错误导致某些模块被评估和执行两次时，就会抛出此错误。重复的模块会导致运行时错误并增加捆绑包大小。

检查依赖项版本

首先，确保您使用的是所有 CKEditor 5 依赖项的最新版本。根据安装方法，您应该检查 ckeditor5、ckeditor5-premium-features 或 @ckeditor/ckeditor5-<NAME> 包的版本。如果您无法更新到最新版本，请确保所有 CKEditor 5 包都处于相同的版本。

如果您使用的是第三方插件，请确保也对其进行更新。如果它们与您使用的 CKEditor 5 版本不兼容，您可能需要降级 CKEditor 5 包（我们不建议这样做）。请插件作者升级依赖项，或分叉他们的项目并自己进行更新。

检查导入

下一步是查看您是如何将 CKEditor 5 导入到您的项目中的。

新的安装方法旨在防止模块重复，因此，如果您还没有使用它们，请考虑更新您的项目。 但是，为了向后兼容，仍然支持几种旧的安装方法，混合使用它们可能会导致模块重复。

以下是 CKEditor 5 包最常见的导入方法。

新的安装方法（NIM） – 从 ckeditor5 和 ckeditor5-premium-features 包中导入。
新的安装方法的优化构建 – 从 @ckeditor/ckeditor5-<NAME>/dist/index.js 中导入。
预定义构建（旧版） – 从 @ckeditor/ckeditor5-build-<NAME> 包中导入。
默认导入（旧版） – 从 @ckeditor/ckeditor5-<NAME> 包中导入（默认导出）。
src（旧版） – 从 @ckeditor/ckeditor5-<NAME>/src/* 中导入。
DLL 构建（旧版） – 从 ckeditor5/build/<NAME> 和 @ckeditor/ckeditor5-<NAME>/build/* 中导入。

避免重复模块的最佳方法是避免混合使用这些安装方法。例如，如果您使用的是特定于优化构建的导入，则应将它们用于所有 CKEditor 5 包。此外，由于预定义构建和 DLL 构建已包含编辑器的核心，因此不能与其他类型的导入一起使用。

下面是一个矩阵，显示哪些安装方法彼此兼容。

	NIM	优化构建	预定义构建	默认导入	`src`	DLL 构建
NIM	✅	✅	❌	❌	❌	❌
优化构建	✅	✅	❌	❌	❌	❌
预定义构建	❌	❌	✅	❌	❌	❌
默认导入	❌	❌	❌	✅	✅	❌
`src`	❌	❌	❌	✅	✅	❌
DLL 构建	❌	❌	❌	❌	❌	✅

如果您使用的是任何第三方插件，请确保您导入它们的方法与您导入 CKEditor 5 的方法兼容。

新的安装方法和优化构建

如果您使用的是新的安装方法，则您只能从 ckeditor5 和 ckeditor5-premium-features 包中导入代码。不要从 @ckeditor/ckeditor5-<NAME> 包中导入代码，除非您按照优化构建大小指南进行操作，并且从 @ckeditor/ckeditor5-<NAME> 包中导入的代码以 /dist/index.js 结尾。

如果您使用的是 CDN，请确保您的项目中没有两次包含某些文件。

有效和无效导入路径的示例

import { ClassicEditor, Highlight } from 'ckeditor5'; // ✅
import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ✅
import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ❌
import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
import '@ckeditor/ckeditor5-highlight/build/highlight.js'; // ❌

(旧版) 预定义构建

如果您使用预定义版本，则无法导入任何其他插件。这些版本已经包含编辑器的核心和选定的插件，导入额外的插件会导致某些模块被捆绑和加载两次。

有效和无效导入路径的示例

import ClassicEditor from '@ckeditor/ckeditor5-build-classic'; // ✅
import { Highlight } from 'ckeditor5'; // ❌
import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ❌
import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight'; // ❌
import '@ckeditor/ckeditor5-highlight/build/highlight'; // ❌

如果您缺少插件列表中的某些功能，您应该切换到新的安装方法，该方法没有此限制。如果您无法迁移到新的安装方法，请尝试使用超级构建。此构建包含所有编辑器功能。

（传统）默认导入和`src`导入

如果您使用传统自定义安装方法，您应该只从 `@ckeditor/ckeditor5-<NAME>` 包中导入代码。虽然您可以从 `@ckeditor/ckeditor5-<NAME>/src/*` 文件中导入代码，但建议不要这样做，因为它会使迁移到新的安装方法更加困难。

如果您使用此安装方法，您不应该从 `ckeditor5`、`ckeditor5-premium-features` 或 `@ckeditor/ckeditor5-build-<NAME>` 包中导入代码。

有效和无效导入路径的示例

import { ClassicEditor } from '@ckeditor/ckeditor5-editor-classic'; // ✅
import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ✅
import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ✅ (not recommended)
import { Highlight } from 'ckeditor5'; // ❌
import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ❌
import '@ckeditor/ckeditor5-highlight/build/highlight'; // ❌

（传统）DLL 构建

如果您使用的是传统 DLL 构建，则不应导入任何非 DLL 模块。

有效和无效导入路径的示例

import 'ckeditor5/build/ckeditor5-dll.js';// ✅
import '@ckeditor/ckeditor5-editor-classic/build/editor-classic.js';// ✅
import '@ckeditor/ckeditor5-highlight/build/highlight.js';// ✅
import { Highlight } from 'ckeditor5'; // ❌
import { Highlight } from '@ckeditor/ckeditor5-highlight/dist/index.js'; // ❌
import { Highlight } from '@ckeditor/ckeditor5-highlight'; // ❌
import Highlight from '@ckeditor/ckeditor5-highlight/src/highlight.js'; // ❌

重新安装`node_modules`

通常，npm 和其他包管理器会对所有包进行重复数据删除 - 例如，`ckeditor5` 只会在 `node_modules/` 中安装一次。但是，已知它偶尔会失败。

为了排除这种可能性，您可以尝试以下操作

删除`node_modules`目录。
删除`package-lock.json`、`yarn.lock` 或`pnpm-lock.yaml`文件（取决于使用的包管理器）。
运行`npm install`以重新安装所有包。
运行`npm ls`以检查像`@ckeditor/ckeditor5-core`这样的包安装了多少次。如果它们安装了不止一次，请验证哪个包导致了这种情况。

`ckfinder-missing-image-plugin`

CKFinder 至少需要一个插件来支持在编辑器中加载的图像。请确保以下任一项

Image（加载两种类型的图像），
或 ImageBlock，
或 ImageInline。

已加载到您的编辑器配置中。

`ckfinder-unknown-openermethod`

`ckfinder.openerMethod`必须是以下之一：“popup”或“modal”。

`cloudservices-init`

内部`WebSocketGateway`错误。

此错误可能是由于 webSocketUrl * `config.cloudServices.webSocketUrl`} 配置错误，或者由于处理 WebSocket 连接的服务不可用。

原始错误传递在`error.data.originalError`属性中。

`cloudservices-reconnection-error`

内部重新连接错误。

`cloudservices-token-not-registered`

提供的`tokenUrl`没有注册到 registerTokenUrl。

`cloudservicescommentsadapter-connect-already-connected`

无法连接到同一个 channelId 多次。

`cloudservicescommentsadapter-disconnect-not-exist`

缺少具有给定`channelId`的服务。

`cloudservicescommentsadapter-service-not-exist`

缺少给定 channelId 的服务。

`collaboration-missing-channelid`

需要唯一的`collaboration.channelId`配置来定义数据存储的名称。请注意，具有相同 channelId 的应用程序实例将共享彼此的数据。

`collection-add-item-already-exists`

此项目已存在于集合中。

`collection-add-item-invalid-index`

传递给 Collection#addMany() 的`index`无效。它必须是 0 到集合长度之间的数字。

`commandcollection-command-not-found`

命令不存在。

参数

commandName : any: 命令的名称。

`commentsrepository-active-missing-comment-thread`

无法将一个不存在的评论线程设置为活动状态。请检查给定 id 的评论线程是否已添加到存储库中。

`commentsrepository-active-not-attached`

无法将未附加的评论线程设置为活动状态。评论线程必须附加到目标元素才能将其设置为活动状态。

`commentsrepository-adapter-already-set`

无法设置适配器多次。

`commentsrepository-add-comment-internal-error`

添加评论时出现错误。

`commentsrepository-add-comment-thread-internal-error`

添加评论线程时出现错误。

`commentsrepository-add-comment-to-missing-comment-thread`

无法将评论添加到不存在的评论线程中。

`commentsrepository-add-comment-user-not-exists`

评论作者未在 Users 插件中定义。

`commentsrepository-attach-missing-comment-thread`

无法附加不存在的评论线程。

`commentsrepository-duplicated-comment-thread-id`

具有给定 id 的评论线程已添加到存储库中。

`commentsrepository-fetch-comment-thread`

获取评论线程失败。

`commentsrepository-get-comment-invalid-id`

评论 ID 必须是字符串。

`commentsrepository-invalid-comment-authorid`

评论作者 ID 必须是字符串。

`commentsrepository-invalid-comment-content`

评论内容必须是字符串。

`commentsrepository-invalid-comment-thread-id`

评论线程 ID 必须是字符串。

`commentsrepository-invalid-commentid`

评论 ID 必须是字符串。

`commentsrepository-missing-comment-thread`

具有给定 id 的评论线程不存在。

`commentsrepository-missing-target`

需要目标才能打开新的评论线程。

`commentsrepository-missing-thread-and-adapter-method`

具有给定 id 的评论线程未添加到编辑器中，也没有定义 adapter.getCommentThread()。请参阅 https://ckeditor.npmjs.net.cn/docs/ckeditor5/latest/features/collaboration/comments/comments-integration.html。

`commentsrepository-remove-comment-internal-error`

删除评论时出现错误。

`commentsrepository-remove-comment-missing-comment-thread`

无法从不存在的评论线程中删除评论。

`commentsrepository-remove-comment-thread-internal-error`

删除评论时出现错误。

`commentsrepository-remove-missing-comment`

无法删除不存在的评论。

`commentsrepository-remove-missing-comment-thread`

无法删除不存在的评论线程。

`commentsrepository-reopen-comment-thread`

具有给定 id 的评论线程未解决。

`commentsrepository-reopen-comment-thread-internal-error`

重新打开评论线程时出现错误。

`commentsrepository-resolve-comment-thread-internal-error`

解决评论线程时出现错误。

`commentsrepository-resolved-comment-thread`

具有给定 id 的评论线程已解决。

`commentsrepository-update-comment-internal-error`

更新评论时出现错误。

`commentsrepository-update-comment-invalid-content`

评论内容必须是字符串。

`commentsrepository-update-comment-missing-comment-thread`

无法更新不存在的评论线程的评论。

`commentsrepository-update-comment-thread-internal-error`

更新评论线程时出现错误。

`commentsrepository-update-missing-comment`

无法更新不存在的评论。

`componentfactory-item-missing`

组件工厂中未注册所需组件。请确保提供的名称正确，并且组件已正确添加到工厂中。

参数

name : any: 缺少组件的名称。

`context-addeditor-private-context`

无法将多个编辑器添加到由编辑器创建的上下文。

`context-initplugins-constructor-only`

仅允许构造函数作为上下文插件。

`context-initplugins-invalid-plugin`

仅允许标记为上下文插件的插件与上下文一起使用。

`contextualballoon-add-view-exist`

尝试添加同一个视图的配置多次。

`contextualballoon-remove-view-not-exist`

尝试删除堆栈中未定义的视图的配置。

`contextualballoon-showstack-stack-not-exist`

尝试显示不存在的堆栈。

`conversion-add-alias-dispatcher-not-registered`

尝试为未注册的调度器注册别名。

`conversion-attribute-to-attribute-on-text`

此错误发生在文本节点的属性要通过 属性到属性转换器 向下转换时。在大多数情况下，它是由转换器配置错误导致的，当时只定义了“通用”转换器

editor.conversion.for( 'downcast' ).attributeToAttribute( {
	model: 'attribute-name',
	view: 'attribute-name'
} ) );

并且给定的属性用于文本节点，例如

model.change( writer => {
	writer.insertText( 'Foo', { 'attribute-name': 'bar' }, parent, 0 );
} );

在这种情况下，要将相同的属性同时转换为 Element 和 Text 节点，还需要定义具有更高优先级的文本特定 属性到元素转换器

editor.conversion.for( 'downcast' ).attributeToElement( {
	model: {
		key: 'attribute-name',
		name: '$text'
	},
	view: ( value, { writer } ) => {
		return writer.createAttributeElement( 'span', { 'attribute-name': value } );
	},
	converterPriority: 'high'
} ) );

`conversion-element-to-structure-disallowed-text`

此错误发生在模型元素通过 elementToStructure 帮助程序向下转换，但该元素被允许托管 `$text`，由模型模式决定。

例如，这可能是由于 `myElement` 在其模式定义中允许 $block 的内容

// Element definition in schema.
schema.register( 'myElement', {
	allowContentOf: '$block',

	// ...
} );

// ...

// Conversion of myElement with the use of elementToStructure().
editor.conversion.for( 'downcast' ).elementToStructure( {
	model: 'myElement',
	view: ( modelElement, { writer } ) => {
		// ...
	}
} );

在这种情况下，可以使用 elementToElement() 帮助程序来解决这个问题

editor.conversion.for( 'downcast' ).elementToElement( {
	model: 'myElement',
	view: ( modelElement, { writer } ) => {
		// ...
	}
} );

参数

elementName : any: 要为其创建结构的元素的名称。

`conversion-for-unknown-group`

尝试将转换器添加到未知的调度器组。

`conversion-model-consumable-not-consumed`

在将模型向下转换为视图时，一些模型项没有被使用。

这可能是以下原因造成的：

某些模型元素缺少转换器。请确保您为所有模型元素注册了向下转换器。
自定义转换器没有使用转换后的项。请确保您使用了从模型转换为视图的所有模型元素。
自定义转换器调用了event.stop()。在提供自定义转换器时，请记住您不应该停止事件。如果您停止它，则最低优先级的默认转换器将不会触发该节点的属性和子节点的转换。

参数

: any: :engine/model/item~Item>} items 未使用的项。

`conversion-slot-filter-incomplete`

提供给writer.createSlot()的过滤器不完整，并且至少排除了一个子元素（其中一个子元素不会被分配到任何插槽）。

参数

element : any: 其子元素无法被正确分配到多个插槽的元素。

`conversion-slot-filter-overlap`

提供给writer.createSlot()的过滤器重叠（至少有两个过滤器接受相同的子元素）。

参数

element : any: 其子元素无法被正确分配到多个插槽的元素。

`conversion-slot-mode-unknown`

在向下转换转换器中，提供给writer.createSlot()的插槽模式未知。

`data-filter-invalid-definition`

数据过滤器无法处理该定义。

请确保注册的定义正确。

`datacontroller-get-detached-root`

检索分离根的文档数据。

这通常表示错误，因为分离根应被视为“已删除”，并且不应包含在文档数据中。

`datacontroller-get-non-existent-root`

无法从不存在的根获取数据。当DataController#get() 方法使用不存在的根名称调用时，会抛出此错误。例如，如果编辑器实例只有一个main根，调用get，例如

data.get( { rootName: 'root2' } );

将抛出此错误。

`datacontroller-init-document-not-empty`

无法将初始数据设置为非空的Document。初始数据应在Editor初始化期间设置一次，此时version等于 0。

`datacontroller-init-non-existent-root`

无法在不存在的根上初始化数据。当DataController#init() 方法使用不存在的根名称调用时，会抛出此错误。例如，如果编辑器实例只有一个main根，调用init，例如

data.init( { main: '<p>Foo</p>', root2: '<p>Bar</p>' } );

将抛出此错误。

`datacontroller-set-non-existent-root`

无法在不存在的根上设置数据。当DataController#set() 方法使用不存在的根名称调用时，会抛出此错误。例如，如果编辑器实例只有一个默认的main根，调用set，例如

data.set( { main: '<p>Foo</p>', root2: '<p>Bar</p>' } );

将抛出此错误。

`detach-operation-on-document-node`

无法分离文档节点。

`document-outline-container-not-provided`

没有提供要注入文档大纲的 DOM 元素。请设置config.documentOutline.container配置选项。

参数

editor : any: 与错误相关的编辑器实例。

`document-outline-invalid-license-key`

无效的许可证密钥。请联系我们的客户支持，网址为：https://ckeditor.npmjs.net.cn/contact/。

`document-outline-trial-license-key-reached-limit-changes`

您已超出试用使用限制（原因：达到文档更改限制）。重新启动编辑器。

请联系我们的客户支持以获取完全访问权限，网址为：https://ckeditor.npmjs.net.cn/contact/。

`document-selection-gravity-wrong-restore`

无法为未知 UID 恢复重力。请确保您使用从overrideSelectionGravity获得的正确 UID 来恢复。

参数

uid : any: 由_overrideGravity返回的唯一标识符。

`document-selection-wrong-position`

来自文档选择的范围在不正确的位置开始或结束。

`domconverter-invalid-attribute-detected`

在渲染过程中忽略了无效的属性名称。

`domconverter-transparent-rendering-unsupported-in-editing-pipeline`

dataPipeline:transparentRendering 标志仅在数据管道中受支持。

`domconverter-unsafe-attribute-detected`

DomConverter在编辑管道中检测到一个交互式属性。为了获得最佳的编辑体验，该属性被重命名为data-ck-unsafe-attribute-[原始属性名称]。

如果您是生成此属性的插件的作者，并且希望它在编辑管道中保留，您可以在模型-视图转换期间使用DowncastWriter创建元素时配置此设置。诸如createContainerElement、createAttributeElement或createEmptyElement的方法接受一个选项，该选项将禁用特定属性的过滤

const paragraph = writer.createContainerElement( 'p',
	{
		class: 'clickable-paragraph',
		onclick: 'alert( "Paragraph clicked!" )'
	},
	{
		// Make sure the "onclick" attribute will pass through.
		renderUnsafeAttributes: [ 'onclick' ]
	}
);

参数

domElement : any: 设置属性的 DOM 元素。
key : any: 属性的原始名称
value : any: 原始属性的值

`domconverter-unsafe-script-element-detected`

在渲染编辑器内容时，DomConverter检测到一个<script>元素，该元素可能会破坏编辑体验。为了避免这种情况，<script>元素被替换为<span data-ck-unsafe-element="script"></span>。

`domconverter-unsafe-style-element-detected`

在渲染编辑器内容时，DomConverter检测到一个<style>元素，该元素可能会影响编辑体验。为了避免这种情况，<style>元素被替换为<span data-ck-unsafe-element="style"></span>。

`easy-image-image-feature-missing`

Easy Image 功能需要加载以下插件之一才能正常工作

ImageBlock,
ImageInline,
Image（加载 ImageBlock 和 ImageInline）

请确保您的编辑器配置正确。

`editingcontroller-reconvertmarker-marker-not-exist`

提供的名称的标记不存在，无法重新转换。

参数

markerName : any: 重新转换标记的名称。

`editor-config-sanitizehtml-not-supported`

CKEditor 43.1.0 版本中删除了配置属性config.sanitizeHtml，并且不再支持。

请改用config.htmlEmbed.sanitizeHtml和/或config.mergeFields.sanitizeHtml。

`editor-create-initial-data`

config.initialData选项不能与作为Editor.create()的第一个参数传递的初始数据一起使用。

`editor-initial-data-replaced-with-revision-data`

编辑器初始数据和初始根属性被最新的修订数据替换，因为编辑器数据与修订数据不同。

这意味着编辑器数据已过时（可能是由于错误，例如在上次编辑会话期间，文档数据未在最后更改后保存）或数据在从编辑器获取后被后处理。

请注意，空格中的更改也被视为差异。

`editor-isreadonly-has-no-setter`

从34.0.0版本开始，Editor#isReadOnly属性是只读的，只能使用Editor#enableReadOnlyMode( lockId )和Editor#disableReadOnlyMode( lockId )进行设置。

34.0.0版本之前的用法

editor.isReadOnly = true;
editor.isReadOnly = false;

34.0.0版本之后的用法

editor.enableReadOnlyMode( 'my-feature-id' );
editor.disableReadOnlyMode( 'my-feature-id' );

`editor-missing-sourceelement`

无法更新分离编辑器的源元素。

如果您没有将元素传递给Editor.create()，则无法调用updateSourceElement()方法。

`editor-read-only-lock-id-invalid`

锁 ID 丢失或不是字符串或符号。

`editor-source-element-already-used`

用于创建编辑器的 DOM 元素（例如，InlineEditor.create()）已被用于创建另一个编辑器实例。请确保每个编辑器都使用唯一的 DOM 元素创建。

参数

element : any: 导致冲突的 DOM 元素。

`editor-ui-deprecated-editable-elements`

EditorUI#_editableElements属性已弃用，并将很快被移除。请改用setEditableElement()和getEditableElement()方法。

参数

editorUI : any: 弃用属性所属的编辑器 UI 实例。

`editor-ui-deprecated-viewport-offset-config`

EditorConfig#toolbar.viewportTopOffset属性已弃用，并将很快被移除。请改用EditorConfig#ui.viewportOffset。

`editor-wrong-element`

当尝试将<textarea>元素传递给编辑器类的create()函数时，会抛出此错误。

唯一可以在<textarea>元素上初始化的编辑器类型是经典编辑器。此编辑器会隐藏传递的元素，并在其旁边插入自己的 UI。其他类型的编辑器会将传递的元素用作其根可编辑元素，因此<textarea>不适合它们。请改用<div>或其他文本容器。

<div id="editor">
	<p>Initial content.</p>
</div>

`editorannotations-invalid-source-callback`

需要函数。

`enableplaceholder-deprecated-text-option`

enablePlaceholder()函数中的“text”选项已弃用，并将很快被移除。

有关如何应用此更改的更多信息，请参阅迁移到 v39指南。

`error-saving-suggestion-data-suggestion-discarded`

在将建议数据保存到数据库时发生了意外错误。为了避免文档数据与建议数据库之间不匹配，文档中的建议已自动丢弃。

`export-word-v1-api-is-deprecated`

您正在 exportWord.converterOptions 中使用 v1 API 接口。请使用新版导出 Word API 更新您的配置。查看迁移指南：https://docx-converter.cke-cs.com/v2/convert/docs#section/Export-to-Word/Migrating-from-v1

`filerepository-no-upload-adapter`

您需要启用上传适配器才能上传文件。

当 FileRepository 在没有定义上传适配器的情况下使用时，会出现此警告。

如果您在使用其中一个 CKEditor 5 构建时看到此警告，则表示您没有配置这些构建中默认提供的任何上传适配器。

预定义构建是一个已弃用的解决方案，我们强烈建议您迁移到新的安装方法。

查看全面的“图像上传概述”，了解构建中有哪些上传适配器以及如何配置它们。

否则，如果您看到此警告，则您可能启用了像 ImageUpload 或 ImageUploadUI 这样的功能，但您没有启用任何上传适配器。您可以从 “图像上传概述” 中列出的现有上传适配器中选择一个。

您也可以实现自己的图像上传适配器。

`filerepository-read-wrong-status`

如果状态与空闲状态不同，则无法调用读取。

`filerepository-upload-wrong-status`

如果状态与空闲状态不同，则无法调用上传。

`fileuploader-decoding-image-data-error`

解码 Base64 图像数据时出现问题。

`fileuploader-missing-api-address`

必须将 Api 地址作为第三个参数提供。

`fileuploader-uploading-data-failed`

上传文件失败。

`focustracker-add-element-already-exist`

此元素已被 FocusTracker 跟踪。

`focustracker-add-view-missing-element`

添加到 FocusTracker 的 View 没有 element。请确保在将视图添加到焦点跟踪器之前 render 视图。

`font-size-invalid-definition`

作为 FontSize 选项提供的值似乎无效。

查看插件配置中描述的有效示例。

`font-size-invalid-use-of-named-presets`

如果 config.fontSize.supportAllValues 为 true，则您需要使用数值作为字体大小选项。

查看插件配置中描述的有效示例。

参数

presets : any: 无效值。

`html-embed-provide-sanitize-function`

当使用 HTML 嵌入功能并将 config.htmlEmbed.showPreviews 设置为 true 时，强烈建议您定义一个清理函数来清理输入的 HTML，以避免 XSS 漏洞。

有关详细信息，请查看 HTML 嵌入功能文档。

`image-block-plugin-required`

必须启用 ImageBlock 插件才能允许插入块图像。查看 type 以了解更多信息。

`image-inline-plugin-required`

必须启用 ImageInline 插件才能允许插入内联图像。查看 type 以了解更多信息。

`image-insert-integration-exists`

有两个插入图像集成以相同名称注册。

请确保您没有加载多个资产管理器插件。

`image-insert-integrations-not-registered`

插入图像功能需要通过单独的功能注册集成。

insertImage 工具栏按钮需要通过其他功能注册集成。例如 ImageUpload、ImageInsert、ImageInsertViaUrl、CKBox

`image-insert-integrations-not-specified`

插入图像功能需要在编辑器配置中提供集成列表。

集成的默认列表是 upload、assetManager、url。如果加载了给定的功能插件，则这些集成将包含在插入图像下拉菜单中。您应该省略 integrations 配置键以使用默认集，或者提供应使用的选定集成列表。

`image-insert-unknown-integration`

指定的插入图像集成名称未知，或者提供插件未加载到编辑器中。

`image-style-configuration-definition-invalid`

配置中提供的图像样式定义无效。

请确保该定义正确地实现了以下定义之一

参数

dropdown : any: 无效下拉菜单的名称
style : any: 无效图像样式选项的名称

`image-style-missing-dependency`

为了正常工作，每个图像样式选项都需要编辑器支持特定模型元素（也称为图像类型）。

可以在样式选项定义的 modelElements 属性中定义可以将图像样式选项应用到的模型元素名称。

查看控制台中的警告，以准确了解不支持哪些选项以及缺少哪些编辑器插件。确保在编辑器中加载这些插件，以使此图像样式选项正常工作。

参数

option : any: 不支持的选项的名称。
missingPlugins : any: 必须加载其中一个插件的名称，以支持特定选项。

`imageresizebuttons-missing-icon`

当为独立按钮配置 config.image.resizeOptions 时，必须为每个选项设置有效的 icon 令牌。

查看插件配置中描述的所有有效选项。

参数

option : any: 无效的图像调整大小选项。

`import-word-plugin-conversion-failed`

导入 Word 文件时出错。查看开发人员工具中浏览器网络选项卡中的云服务响应，以了解原因。

`import-word-plugin-import-cancelled`

导入过程已取消。Word 文件内容应插入的位置不再存在，因为文档结构已更改。再次选择位置，然后尝试再次导入 Word 文件。

`inlineannotations-attach-already-attached`

无法两次附加同一个批注。

`inlineannotations-detach-not-attached`

无法分离未附加的 UI。

`inlineannotations-not-allowed-with-context`

InlineAnnotations 插件不允许作为 Context 插件使用。它只能用作编辑器插件。

`insert-operation-position-invalid`

插入位置无效。

`insertcontent-invalid-insertion-position`

在将插入的内容与其同级元素合并时发生内部错误。插入位置应等于合并位置。

如果您遇到此错误，请向 CKEditor 5 团队报告此错误，并提供尽可能多的有关插入内容和插入位置的详细信息。

`insertcontent-wrong-position`

给定的节点无法插入到给定位置。

参数

node : any: 要插入的节点。
position : any: 在其中插入节点的位置。

`insertobject-element-not-an-object`

尝试使用 insertObject() 函数插入一个元素，该元素未在模式中定义为对象。查看 SchemaItemDefinition。如果您要插入不是对象的內容，则可能需要使用 insertContent() 函数。

`insertobject-invalid-place-parameter-value`

不支持的 options.setSelection 参数传递给 insertObject() 函数。查看 insertObject() API 文档以了解允许的 options.setSelection 参数值。

`invalid-license-key`

无效的许可证密钥。请联系我们的客户支持，网址为：https://ckeditor.npmjs.net.cn/contact/。

`list-feature-conflict`

List 功能无法与 LegacyList 插件一起加载。

参数

conflictPlugin : any: 插件名称。

`locale-deprecated-language-property`

Locale#language 属性已弃用，将在不久的将来删除。请改用 Locale#uiLanguage 和 Locale#contentLanguage 属性。

`mapping-model-position-view-parent-not-found`

模型位置无法映射到视图，因为模型位置的父级没有映射的视图元素（可能尚未转换或没有转换器）。

请确保模型元素已正确转换为视图。

`markercollection-incorrect-marker-name`

标记名称不能包含“，”字符。

`markercollection-refresh-marker-not-exists`

具有给定名称的标记不存在。

`matcher-pattern-deprecated-attributes-class-key`

attributes 选项的键值匹配器模式使用已弃用的 class 键。

改用 classes 匹配器模式选项

// Instead of:
const pattern = {
	attributes: {
		key1: 'value1',
		key2: 'value2',
		class: 'foobar'
	}
}

// Use:
const pattern = {
	attributes: {
		key1: 'value1',
		key2: 'value2'
	},
	classes: 'foobar'
}

请参考迁移到 v29.1.0 指南和 MatcherPattern 文档。

参数

pattern : any: 缺少属性的模式。

`matcher-pattern-deprecated-attributes-style-key`

attributes 选项的键值匹配器模式使用已弃用的 style 键。

改用 styles 匹配器模式选项

// Instead of:
const pattern = {
	attributes: {
		key1: 'value1',
		key2: 'value2',
		style: /^border.*$/
	}
}

// Use:
const pattern = {
	attributes: {
		key1: 'value1',
		key2: 'value2'
	},
	styles: /^border.*$/
}

请参考迁移到 v29.1.0 指南和 MatcherPattern 文档。

参数

pattern : any: 缺少属性的模式。

`matcher-pattern-missing-key-or-value`

键值匹配器模式缺少键或值。两者都必须存在。请参考文档：MatcherPattern。

参数

pattern : any: 缺少属性的模式。

`media-embed-no-provider-name`

媒体嵌入配置中指定的提供商（或额外提供商）之一没有名称，编辑器不会使用它。要使此媒体提供商正常工作，请仔细检查编辑器配置。

`mentioncommand-incorrect-marker`

标记必须是一个字符。

正确的标记：'@'，'#'。

不正确的标记：'@@'，'[@'。

参见 MentionConfig。

`mentionconfig-incorrect-marker`

标记必须是一个字符。

正确的标记：'@'，'#'。

不正确的标记：'$$'，'[@'。

参见 MentionConfig。

参数

标记：任何: 配置的标记

无法将不受支持的组件添加到 MenuBarView。

组件应为 MenuBarMenuView（子菜单）或 MenuBarMenuListItemButtonView（按钮）。

参数

componentName：任何: 配置中使用的不受支持组件的名称。
componentView：任何: 不受支持的组件视图。

处理菜单栏配置时出现问题。无法从菜单栏配置中删除具有给定名称的项。

此警告通常出现在应该提供菜单栏项的 Plugin 未加载或菜单栏配置中存在拼写错误时。

参数

menuBarConfig：任何: 菜单栏的完整配置。
itemName：任何: 未从菜单栏中删除的项的名称。

处理菜单栏配置时出现问题。无法添加配置的项，因为它应该添加到的位置不存在。

此警告通常出现在应该提供菜单栏项的 Plugin 未加载或菜单栏配置中存在拼写错误时。

参数

menuBarConfig：任何: 菜单栏的完整配置。
itemName：任何: 未从菜单栏中删除的项的名称。

处理菜单栏配置时出现问题。具有给定名称的项不存在，因此在呈现菜单栏时被省略。

此警告通常出现在应该提供菜单栏项的 Plugin 未加载或菜单栏配置中存在拼写错误时。

确保负责此菜单栏项的插件已加载，并且菜单栏配置正确，例如，'menuBar:bold' 菜单栏项已加载 BoldUI。

参数

menuBarConfig：任何: 菜单栏的完整配置。
parentMenuConfig：任何: 定义不可用组件的菜单的配置。
componentName：任何: 不可用组件的名称。

处理菜单栏配置时出现问题。其中一个菜单为空，因此在呈现菜单栏时被省略。

此警告通常出现在负责提供菜单栏项的一些插件未加载，并且菜单栏配置未更新时。

确保加载所有必要的编辑器插件，或更新菜单栏配置以考虑缺少的菜单项。

参数

menuBarConfig：任何: 菜单栏的完整配置。
emptyMenuConfig：任何: 没有子项的菜单的定义。

`merge-fields-data-set-not-found`

未找到请求的数据集。

`merge-fields-duplicate-data-set-id`

数据集 ID 必须是唯一的。

`merge-fields-duplicate-group-id`

合并字段组 ID 必须是唯一的。

`merge-fields-duplicate-merge-field-id`

合并字段 ID 必须是唯一的。

`merge-fields-invalid-license-key`

无效的许可证密钥。请联系我们的客户支持，网址为：https://ckeditor.npmjs.net.cn/contact/。

`merge-fields-invalid-prefix-or-suffix`

合并字段前缀和后缀只能包含以下字符：'"`!#%:;=@{}~$()*+/?[\]^|。

`merge-fields-invalid-preview-mode-set`

尝试设置的预览模式不可用。有关更多信息，请参阅预览模式配置。

`merge-fields-invalid-preview-modes-configuration`

无效的预览模式定义。它应该是一个非空的数组，其中包含以下一个或多个值：'$labels'、'$defaultValues' 和 '$dataSets'。

`merge-fields-prefix-and-suffix-must-differ`

合并字段前缀和后缀必须不同。

`merge-fields-prefix-or-suffix-too-long`

合并字段前缀和后缀不能超过 8 个字符。

`merge-fields-provide-sanitize-function`

当将合并字段功能与 config.mergeFields.previewHtmlValues 设置为 true 一起使用时，强烈建议定义一个清理函数来清理输入 HTML，以避免 XSS 漏洞。

有关详细概述，请查看合并字段功能文档。

`merge-fields-trial-license-key-reached-limit-changes`

您已超出试用使用限制（原因：达到文档更改限制）。重新启动编辑器。

请联系我们的客户支持以获取完全访问权限，网址为：https://ckeditor.npmjs.net.cn/contact/。

`merge-operation-how-many-invalid`

合并操作指定了错误的节点移动数量。

`merge-operation-source-position-invalid`

合并源位置无效。要合并的元素必须具有父节点。

`merge-operation-target-position-invalid`

合并目标位置无效。要合并的元素必须具有父节点。

`model-createpositionat-offset-required`

Model#createPositionAt() 要求在第一个参数为模型项时指定偏移量。

`model-document-createroot-name-exists`

具有指定名称的根已经存在。

`model-document-history-addoperation-incorrect-version`

只有具有匹配版本的运算才能添加到历史记录中。

参数

errorData：任何: 操作和当前文档历史记录版本。

`model-liveposition-root-not-rootelement`

LivePosition 的根必须是 RootElement 的实例。

`model-nodelist-index-out-of-bounds`

在节点列表中找不到给定的索引。

`model-nodelist-insertnodes-not-node`

尝试插入不是 Node 实例的对象。

`model-nodelist-offset-out-of-bounds`

在节点列表中找不到给定的偏移量。

参数

nodeList：任何: 节点列表的字符串化。

`model-position-fromjson-no-root`

无法为文档创建位置。具有指定名称的根不存在。

`model-position-parent-incorrect`

位置父级必须是模型元素或模型文档片段。

`model-position-path-incorrect`

位置的路径不正确。这意味着位置没有指向树中的正确位置，因此，它的某些方法和 getter 无法正常工作。

注意：与 DOM 和视图位置不同，在模型中，位置的父级始终是元素或文档片段。位置路径中的最后一个偏移量是此元素中此位置指向的点。

在编辑引擎架构指南中阅读有关模型位置和偏移量的更多信息。

参数

position : any: 不正确的位置。

`model-position-path-incorrect-format`

位置路径必须是一个至少包含一个项目的数组。

`model-selection-range-intersects`

尝试添加与选择中的另一个范围相交的范围。

参数

addedRange：任何: 添加到选择的范围。
intersectingRange：任何: 选择中与 addedRange 相交的范围。

`model-selection-set-ranges-not-range`

选择范围设置为不是 Range 实例的对象。

只能使用 Range 实例来设置选择。导致此错误的常见错误是

使用 DOM Range 对象，
CKEditor 5 安装不正确，多个 ckeditor5-engine 包具有不同的版本。

`model-selection-setfocus-no-ranges`

如果选择中没有范围，则无法设置选择焦点。

`model-selection-setto-not-selectable`

无法将选择设置为给定位置。

在设置选择时指定了无效的参数。常见问题

传递了 TextProxy 实例，而不是真正的 Text。
传递了视图节点，而不是模型节点。
传递了 null/undefined。

`model-selection-setto-required-second-parameter`

当第一个参数是节点时，selection.setTo 需要第二个参数。

`model-textproxy-wrong-length`

给定的 length 值不正确。

`model-textproxy-wrong-offsetintext`

给定的 offsetInText 值不正确。

`model-tree-walker-no-start-position`

TreeWalker 的边界或起始位置均未定义。

`model-tree-walker-unknown-direction`

只允许 backward 和 forward 方向。

`model-writer-insert-forbidden-move`

无法将节点从一个文档移动到不同的树。禁止将已经位于文档中的节点移出文档。

`move-operation-node-into-itself`

尝试将一组节点移动到该组中的一个节点中。

`move-operation-nodes-do-not-exist`

要移动的节点不存在。

`move-operation-range-into-itself`

尝试将一组节点移动到该组的中间。

`multi-root-editor-cannot-disable-graveyard-root`

您无法禁用 $graveyard 根。

`multi-root-editor-load-root-already-loaded`

要加载的根之前已经加载过。loadRoot() 调用没有效果。

`multi-root-editor-load-root-no-root`

要加载的根不存在。

`multi-root-editor-root-attributes-no-root`

尝试在不存在的根上设置属性。

rootsAttributes 中指定的根与初始编辑器根不匹配。

`multi-root-editor-root-initial-data-mismatch`

编辑器根与 initialData 配置不匹配。

这可能发生在以下两种情况之一

配置错误。 MultiRootEditor.create() 中的 sourceElementsOrData 参数包含与 initialData 配置不同的根。
在初始化编辑器时，initialData 配置值或编辑器根的状态发生了更改。

`narrowsidebar-attach-already-attached`

无法将狭窄侧边栏附加两次。

`narrowsidebar-detach-not-attached`

无法分离未附加的侧边栏。

`observable-bind-duplicate-properties`

属性必须是唯一的。

`observable-bind-to-extra-callback`

不能在一次绑定中绑定多个属性并使用回调函数。

`observable-bind-to-many-not-one-binding`

将一个属性绑定到多个可观察对象只能使用一个属性。

`observable-bind-to-no-callback`

绑定多个可观察对象只能使用回调函数。

`observable-bind-to-parse-error`

to() 中的语法无效。

`observable-bind-to-properties-length`

属性数量必须匹配。

`observable-bind-wrong-properties`

所有属性必须是字符串。

`observable-set-cannot-override`

无法覆盖现有属性。

当尝试使用 set 方法设置一个与已有属性同名的属性时，就会抛出此错误。例如

let observable = new Model();
observable.property = 1;
observable.set( 'property', 2 );			// throws

observable.set( 'property', 1 );
observable.set( 'property', 2 );			// ok, because this is an existing property.

`observable-unbind-wrong-properties`

属性必须是字符串。

`observablemixin-cannot-decorate-undefined`

无法装饰未定义的方法。

参数

object : any: 要装饰其方法的对象。
methodName : any: 不存在的方法名。

`operation-utils-move-range-not-flat`

尝试移动一个开始和结束位置位于不同元素的范围。

`operation-utils-remove-range-not-flat`

尝试删除一个开始和结束位置位于不同元素的范围。

`pagination-config-not-found`

分页插件所需的配置丢失。请按照分页功能文档中提供的说明正确初始化插件。

参数

config : any: 编辑器的配置。

`pagination-invalid-license-key`

无效的许可证密钥。请联系我们的客户支持，网址为：https://ckeditor.npmjs.net.cn/contact/。

`pagination-trial-license-key-reached-limit-changes`

您已超出试用使用限制（原因：达到文档更改限制）。重新启动编辑器。

请联系我们的客户支持以获取完全访问权限，网址为：https://ckeditor.npmjs.net.cn/contact/。

`pendingactions-add-invalid-message`

消息必须是字符串。

`permissions-set-permissions-invalid-channel-id`

尝试为不存在的 channelId 设置权限。

`plugin-obsolete-documentlist`

DocumentList 插件已过时。请使用 List 代替。

`plugin-obsolete-documentlistproperties`

DocumentListProperties 插件已过时。请使用 ListProperties 代替。

`plugin-obsolete-tododocumentlist`

TodoDocumentList 插件已过时。请使用 TodoList 代替。

`plugincollection-context-required`

如果一个插件是上下文插件，它所依赖的所有插件也应该改为上下文插件而不是普通插件。换句话说，如果一个插件可以在上下文中使用，它所有依赖的插件也应该能够在上下文中使用。请注意，上下文只提供编辑器 API 的一部分。如果一个插件需要完整的编辑器 API，那么所有依赖它的插件都应该被视为需要完整编辑器 API 的插件。

参数

plugin : any: 所需插件的名称。
requiredBy : any: 父插件的名称。

`plugincollection-plugin-for-replacing-cannot-have-dependencies`

用于替换现有插件的插件不能依赖其他插件。

`plugincollection-plugin-for-replacing-not-exist`

被替换的插件在可用插件集合中不存在。

`plugincollection-plugin-for-replacing-not-loaded`

被替换的插件不会被加载，因此不能被替换。

`plugincollection-plugin-name-conflict`

加载了两个具有相同 pluginName 的插件。这会导致这些插件之间在运行时发生冲突。

实际上，此警告通常意味着向现有 CKEditor 5 构建中添加了新插件。插件应该始终添加到编辑器的源版本（@ckeditor/ckeditor5-editor-*）中，而不是添加到从 @ckeditor/ckeditor5-build-* 包之一导入的编辑器中。

检查导入路径以及传递给 Editor.create() 的插件列表或在 Editor.builtinPlugins 中指定的插件列表。

预定义构建是一个已弃用的解决方案，我们强烈建议您迁移到新的安装方法。

第二种可能是你的 node_modules/ 目录包含了同一个 CKEditor 5 包的重复版本。通常情况下，在干净安装时，npm 会在 node_modules/ 中对包进行去重，因此调用 rm -rf node_modules && npm i 就足够了。但是，如果你安装了某些包的冲突版本，它们的依赖项可能需要安装多个版本，这会导致此警告。

从技术上讲，此错误发生是因为在向现有编辑器构建中添加插件后，该插件的依赖项会被重复。它们已经被构建到该编辑器构建中，现在作为你正在安装的插件的依赖项被添加了第二次。

参数

pluginName : any: 重复的插件名称。
plugin1 : any: 第一个插件构造函数。
plugin2 : any: 第二个插件构造函数。

`plugincollection-plugin-not-found`

插件不可用，无法加载。

插件类（构造函数）需要在被按名称加载之前提供给编辑器。这通常在 CKEditor 5 构建中通过设置 builtinPlugins 属性来完成。

**如果你在使用 CKEditor 5 构建之一时看到此警告，则意味着你尝试启用该构建中未包含的插件。这可能是由于插件名称拼写错误，或者仅仅是因为该插件不是此构建的一部分。**

预定义构建是一个已弃用的解决方案，我们强烈建议您迁移到新的安装方法。

**如果你在直接使用编辑器创建者之一时看到此警告（不是构建），则意味着你尝试按名称加载插件。但是，与 CKEditor 4 不同，CKEditor 5 没有实现“插件加载器”。这意味着 CKEditor 5 不知道从哪里加载插件模块。因此，你需要通过引用（作为构造函数）提供每个插件。在快速入门指南中查看示例。**

参数

plugin : any: 无法加载的插件的名称。

`plugincollection-plugin-not-loaded`

插件未加载，无法获取。

插件类（构造函数）需要提供给编辑器，并且必须在从插件集合中获取之前加载。

注意：你可以使用 editor.plugins.has() 来检查插件是否已加载。

参数

plugin : any: 未加载的插件的名称。

`plugincollection-replace-plugin-invalid-type`

用于替换现有插件的插件必须是函数。

`plugincollection-replace-plugin-missing-name`

用于替换现有插件的插件必须具有名称。

`plugincollection-replaced-plugin-cannot-have-dependencies`

被替换的插件不能依赖其他插件。

`plugincollection-required`

无法加载插件，因为它的一个依赖项在 removePlugins 选项中列出。

参数

plugin : any: 所需插件的名称。
requiredBy : any: 父插件的名称。

`plugincollection-soft-required`

在插件列表中未找到所需的“软”依赖项。

在配置编辑器时，无论是在构建之前（通过 Editor.builtinPlugins）还是在创建编辑器的实例时（例如，通过 config.plugins），都需要提供你所使用的其他插件的一些依赖项。

当其中一个依赖项未提供时，就会抛出此错误。可以在 missingPlugin 中找到丢失的插件的名称，可以在 requiredBy 中找到需要它的插件。

为了解决它，你需要导入丢失的插件并将它添加到当前插件列表中（Editor.builtinPlugins 或 config.plugins/config.extraPlugins）。

软依赖项是在 26.0.0 版本中引入的。如果你在升级到 26.0.0 版本时遇到此错误，请参阅迁移到 26.0.0 指南。

参数

missingPlugin : any: 所需插件的名称。
requiredBy : any: 需要另一个插件的插件的名称。

`presencelist-collapseat-invalid-format`

config.presenceList.collapseAt 配置值必须是一个大于 0 的数字。

`presencelist-missing-container`

缺少存在列表的容器元素。请确保 config.presenceList.container 已设置并引用了现有 DOM 元素。

`range-create-from-ranges-empty-array`

必须将至少一个范围传递给 Range._createFromRanges()。

`realtimecollaborationclient-editor-setdata-and-editor-data-set-are-forbidden-in-real-time-collaboration`

尝试在实时协作中使用 editor.setData() 或 editor.data.set()。在实时协作中重置数据通常意味着错误（不正确的集成或插件）。使用它可能会覆盖远程客户端上的本地（尚未同步）更改。如果你尝试设置编辑器的初始数据，请改用 initialData 配置选项。如果你尝试在插件中设置编辑器数据，请考虑通过 Writer 在 model.change() 块中应用更改。如果你了解在实时协作中使用 editor.data.set() 的影响，并且想要抑制此错误，请在 editor.data.set() 调用中的第二个参数中将 suppressErrorInCollaboration 标志设置为 true：editor.data.set( '<p>Your data</p>', { suppressErrorInCollaboration: true } )。

参数

itemName：任何: 正在扩展的模型元素的名称。

`schema-cannot-register-item-twice`

同一个项目不能在模式中注册两次。

这种情况可能发生在

两个或多个插件使用相同的名称调用了 register()。这通常意味着插件之间发生冲突，这些插件试图在模型中使用同一个元素。不幸的是，解决此问题的唯一方法是修改其中一个插件，使其使用唯一的模型元素名称。
同一个插件被加载了两次。这发生在它被 npm/yarn 安装了两个版本时，通常意味着以下问题之一
- 版本不匹配（你的两个依赖项需要此插件的两个不同版本），
- 导入不正确（此插件以某种方式被导入了两次，这使 webpack 混乱），
- node_modules/ 中的混乱（rm -rf node_modules/ 可能会有帮助）。

注意：查看记录的 itemName 以更好地理解哪个插件被复制/冲突。

参数

itemName：任何: 正在注册两次的模型元素的名称。

容器元素不是 HTMLElement。

传递了一个未在配置中指定的名称（例如，CSS 类名），
当尝试将不允许在给定元素上应用的样式应用时。

注意： 如果令牌的自动刷新选项已启用，则将在成功或令牌的销毁之前尝试刷新。

参数

autoRefresh : any: 令牌是否会保持自动刷新。

`toolbarview-item-unavailable`

在处理工具栏的配置时出现问题。具有给定名称的项目不存在，因此在渲染工具栏时被省略了。

此警告通常在应该提供工具栏项目的 Plugin 未加载或工具栏配置中存在拼写错误时出现。

确保为该工具栏项目负责的插件已加载，并且工具栏配置正确，例如，为 'bold' 工具栏项目加载了 Bold。

您可以使用以下代码段检索所有可用的工具栏项目

Array.from( editor.ui.componentFactory.names() );

参数

item : any: 组件或嵌套工具栏定义的名称。

`toolbarview-line-break-ignored-when-grouping-items`

工具栏多行换行（- 项目）仅在工具栏配置中禁用自动按钮分组时才有效。为此，请在编辑器配置中将 shouldNotGroupWhenFull 选项设置为 true

const config = {
	toolbar: {
		items: [ ... ],
		shouldNotGroupWhenFull: true
	}
}

详细了解工具栏配置。

工具栏配置中的下拉菜单定义缺少文本标签。

没有标签，下拉菜单将无法访问依赖辅助技术的用户。请确保在下拉菜单配置中设置 label 属性

 {
 	label: 'A human-readable label',
	icon: '...',
	items: [ ... ]
 },

详细了解工具栏配置。

下拉菜单的子视图缺少 focus() 方法，因此当下拉菜单打开时无法获取焦点。

在这种情况下，使下拉菜单的内容可获取焦点可以极大地提高可访问性。请确保视图实例实现可聚焦接口，以获得最佳的用户体验。

下拉菜单的子视图无法获取焦点，因为它缺少 focus() 方法。

当下拉菜单打开并尝试获取其面板的第一个子项的焦点，但子项未实现可聚焦接口时，将出现此警告。

在打开时将焦点设置到下拉菜单的内容上可以极大地提高可访问性。请确保视图实例提供 focus() 方法，以获得最佳的用户体验。

参数

textareaView : any: 配置错误的 textarea 视图实例。
minRows : any: minRows 属性的值。
maxRows : any: maxRows 属性的值。

参数

addedRange：任何: 添加到选择的范围。
intersectingRange：任何: 与addedRange相交的选择范围。

像DowncastWriter#remove()、DowncastWriter#clean()、DowncastWriter#wrap()、DowncastWriter#unwrap()这样的方法需要在范围上调用，该范围的起始和结束位置位于同一个容器元素中。两个位置都可以在其他元素（例如属性元素）内嵌套，但最近的容器祖先必须相同。

consumables.add( { attributes: [ 'class', 'style' ] } );

而每个类和样式都应该单独注册

consumables.add( { classes: 'some-class', styles: 'font-weight' } );

ClassicEditor.create( document.createElement( 'div' ), {
	cloudServices: {
		webSocketUrl: "YOUR_WEBSOCKET_URL"
		// ...
	}
	// ...
} );

参数

element : any: 传递给toWidget()的视图元素。

具有给定 ID 的工具栏已添加。

参数

toolbarId : any: 工具栏 ID。

当注册新的部件工具栏时，需要提供一个非空的数组，其中包含要插入工具栏的项目。

如果在集成编辑器时看到此错误，可能是忘记配置其中一个部件工具栏。

例如，请参见

参数

toolbarId : any: 未正确配置的工具栏的 ID。

参数

markerName : any: 更新的标记的名称。