Editor Resizing Customization
This feature is provided through the Editor Resize plugin that is included in the Standard and Full presets available from the official CKEditor Download site. You can also add it to your custom build with online builder.
When the Editor Resize plugin is enabled, it adds the resize handle (◢) at the bottom of the editor user interface and allows users to manually resize the editor window to desired dimensions.
The resize feature is highly customizable. It is possible to define the resizing direction or maximum and minimum editor size after the resize. Additionally, this plugin provides the CKEDITOR.editor.resize method which allows for resizing the editor on the fly.
# Disabling Editor Resizing
To prevent the editor from being resized you can use the CKEDITOR.config.removePlugins setting to remove the Editor Resize (
config.removePlugins = 'resize';
You can also disable this feature by setting the CKEDITOR.config.resize_enabled configuration option to
config.resize_enabled = false;
# Changing Editor Size on the Fly
Besides defining a default size of the editor window you can also change the size of a CKEditor instance on the fly.
To achieve this, use the editor.resize() method to define the dimensions of the editor interface, assigning the window a width and height value in pixels or CSS-accepted units.
// Set editor width to 100% and height to 350px. editor.resize( '100%', '350' );
While setting the height value, use the
isContentHeight parameter to decide whether the value applies to the entire editor interface or just the editing area.
// The height value now applies to the editing area. editor.resize( '100%', '350', true );
# Limiting the Width and Height for CKEditor Resizing
It is also possible to define the minimum and maximum dimensions after resizing to prevent the editor window from becoming too small or too big to handle.
config.resize_minWidth = 300; config.resize_minHeight = 300;
config.resize_maxWidth = 800; config.resize_maxHeight = 600;
# Limiting the Resizing Directions
Additionally, you can define the resizing directions in order to have more control over the resulting editor appearance.
By default CKEditor is allowed to only resize vertically. This is achieved thanks to setting the CKEDITOR.config.resize_dir configuration option to
config.resize_dir = 'vertical';
If you set the CKEDITOR.config.resize_dir configuration option to
'horizontal', CKEditor window will only be resizable in horizontal dimension.
config.resize_dir = 'horizontal';
If you want to allow both vertical and horizontal resizing, you need to set the CKEDITOR.config.resize_dir configuration option to
config.resize_dir = 'both';
# Editor Resizing Customization Demo
See the working “Editor Resizing Customization” sample that showcases an editor instance with modified resizing settings.
# Related Features
Refer to the following resources for more information about editor resizing:
- The Setting Editor Size article explains how to set the editor width and height.
- The Auto Grow feature allows the editor to automatically expand and shrink vertically depending on the amount and size of content entered in its editing area.