Frequently asked questions
# How to set the height of CKEditor 5?
The height of the editing area can be easily controlled with CSS.
.ck.ck-content:not(.ck-comment__input *) {
height: 300px;
overflow-y: auto;
}
# Why does the editor filter out my content (styles, classes, elements)?
CKEditor 5 implements a custom data model. This means that every piece of content that is loaded into the editor needs to be converted to that model and then rendered back to the view.
Each kind of content must be handled by some feature. For instance the ckeditor5-basic-styles
package handles HTML elements such as <b>
, <i>
, <u>
, etc. along with their representation in the model. The feature defines the two–way conversion between the HTML (view) and the editor model.
If you load some content unknown to any editor feature, it will be dropped. If you want all the HTML5 elements to be supported, you need to write plugins to support them. Once you do that, CKEditor 5 will not filter anything out.
# How to turn the source mode on?
The source editing feature provides basic support for viewing and editing the source of the document.
# The build I downloaded is missing some features. How do I add them?
See the Installing plugins guide to learn how to extend the editor with some additional features.
You can learn which editor features are available in the feature index.
# How to insert some content into the editor?
Because CKEditor 5 uses a custom data model, whenever you want to insert anything, you should modify the model first, which is then converted back to the view where the users input their content (called “editable”). In CKEditor 5, HTML is just one of many possible output formats. You can learn more about the ways of changing the model in the dedicated guide.
To insert a new link at the current position, use the following snippet:
editor.model.change( writer => {
const insertPosition = editor.model.document.selection.getFirstPosition();
writer.insertText( 'CKEditor 5 rocks!', { linkHref: 'https://ckeditor.com/' }, insertPosition );
} );
And to insert some plain text, you can use a slightly shorter one:
editor.model.change( writer => {
writer.insertText( 'Plain text', editor.model.document.selection.getFirstPosition() );
} );
You may have noticed that a link is represented as a text with an attribute in the editor model. See the API of the model writer to learn about other useful methods that can help you modify the editor model.
To insert some longer HTML code, you can parse it to the model fragment first and then insert it into the editor model:
const content = '<p>A paragraph with <a href="https://ckeditor.com">some link</a>.';
const viewFragment = editor.data.processor.toView( content );
const modelFragment = editor.data.toModel( viewFragment );
editor.model.insertContent( modelFragment );
# How to list all instances of the editor?
By default, CKEditor 5 has no global registry of editor instances. But if necessary, such feature can be easily implemented as explained in this Stack Overflow answer.
# How to enable image drag&drop and upload? Where should I start?
The Image and Image upload features are enabled by default in all editor builds. However, to fully enable image upload when installing CKEditor 5 you need to configure one of the available upload adapters. Check out the comprehensive “Image upload” guide to find out the best image upload strategy for your project.
# How to use CKEditor 5 with frameworks (Angular, React, Vue, etc.)?
For the full list of official integrations see the “Official integrations” section.
If an official integration for the framework of your choice does not exist yet, make sure to read the “Integrating CKEditor 5 with JavaScript frameworks” guide. CKEditor 5 offers a rich JavaScript API and predefined builds that make it possible to use CKEditor 5 with whichever framework you need.
We plan to provide more official integrations with time. Your feedback on what should we work on next will be most welcome!
# How to get a full–featured editor build?
We have prepared a build containing almost all available plugins, and it is called the superbuild. Instructions on how to integrate it quickly can be found in the quick start guide.
In the predefined builds guide, there are details available about the superbuild, together with the list of features included in the superbuild, compared to other types of builds.
# How to customize the CKEditor 5 icons?
The easiest way is to use webpack’s NormalModuleReplacementPlugin
plugin. For example, to replace the bold icon use the following code in your webpack.config.js
:
...
plugins: [
new webpack.NormalModuleReplacementPlugin(
/bold\.svg/,
'/absolute/path/to/my/icon.svg'
)
]
You can also use the relative path which is resolved relative to the resource that imports bold.svg
(the BoldUI
class file in this scenario).
Learn more about building CKEditor 5 using webpack.
# How to get the editor instance object from the DOM element?
If you have a reference to the editor editable’s DOM element (the one with the .ck-editor__editable
class and the contenteditable
attribute), you can access the editor instance this editable element belongs to using the ckeditorInstance
property:
<!-- The editable element in the editor's DOM structure. -->
<div class="... ck-editor__editable ..." contenteditable="true">
<!-- Editable content. -->
</div>
// A reference to the editor editable element in the DOM.
const domEditableElement = document.querySelector( '.ck-editor__editable' );
// Get the editor instance from the editable element.
const editorInstance = domEditableElement.ckeditorInstance;
// Use the editor instance API.
editorInstance.setData( '<p>Hello world!<p>' );
# How to add an attribute to the editor editable in DOM?
If you have a reference to the editor instance, simply use the change()
method of the view and set the new attribute via the view downcast writer:
editor.editing.view.change( writer => {
const viewEditableRoot = editor.editing.view.document.getRoot();
writer.setAttribute( 'myAttribute', 'value', viewEditableRoot );
} );
If you do not have the reference to the editor instance but you have access to the editable element in the DOM, you can access it using the ckeditorInstance
property and then use the same API to set the attribute:
const domEditableElement = document.querySelector( '.ck-editor__editable' );
const editorInstance = domEditableElement.ckeditorInstance;
editorInstance.editing.view.change( writer => {
// Map the editable element in the DOM to the editable element in the editor's view.
const viewEditableRoot = editorInstance.editing.view.domConverter.mapDomToView( domEditableElement );
writer.setAttribute( 'myAttribute', 'value', viewEditableRoot );
} );
Every day, we work hard to keep our documentation complete. Have you spotted outdated information? Is something missing? Please report it via our issue tracker.