New Features:
- #932: Introduced Easy Image feature for inserting images that are automatically rescaled, optimized, responsive and delivered through a blazing-fast CDN. Three new plugins were added to support it:
- #1338: Keystroke labels are displayed for function keys (like F7, F8).
-
#643: The File Browser plugin can now upload files using XHR requests. This allows for setting custom HTTP headers using the
config.fileTools_requestHeadersconfiguration option. - #1365: The File Browser plugin uses XHR requests by default.
-
#1399: Added the possibility to set
CKEDITOR.config.startupFocusasstartorendto specify where the editor focus should be after the initialization. -
#1441: The Magic Line plugin line element can now be identified by the
data-cke-magic-line="1"attribute.
Fixed Issues:
- #595: Fixed: Pasting does not work on mobile devices.
- #869: Fixed: Empty selection clears cached clipboard data in the editor.
- #1419: Fixed: The Widget Selection plugin selects the editor content with the Alt+A key combination on Windows.
-
#1274: Fixed: Balloon Toolbar does not match a single selected image using the
contextDefinition.cssSelectormatcher. - #1232: Fixed: Balloon Toolbar buttons should be registered as focusable elements.
-
#1342: Fixed: Balloon Toolbar should be re-positioned after the
changeevent. - #1426: [IE8-9] Fixed: Missing Balloon Toolbar background in the Kama skin. Thanks to Christian Elmer!
- #1470: Fixed: Balloon Toolbar is not visible after drag and drop of a widget it is attached to.
- #1048: Fixed: Balloon Panel is not positioned properly when a margin is added to its non-static parent.
- #889: Fixed: Unclear error message for width and height fields in the Image and Enhanced Image plugins.
- #859: Fixed: Cannot edit a link after a double-click on the text in the link.
-
#1013: Fixed: Paste from Word does not work correctly with the
config.forcePasteAsPlainTextoption. - #1356: Fixed: Border parse function does not allow spaces in the color value.
-
#1010: Fixed: The CSS
bordershorthand property was incorrectly expanded ignoring theborder-colorstyle. - #1535: Fixed: Widget mouseover border contrast is insufficient.
- #1516: Fixed: Fake selection allows removing content in read-only mode using the Backspace and Delete keys.
- #1570: Fixed: Fake selection allows cutting content in read-only mode using the Ctrl/Cmd + X keys.
- #1363: Fixed: Paste notification is unclear and it might confuse users.
API Changes:
-
#1346: Balloon Toolbar context manager API is now available in the
pluginDefinition.initmethod of the requiringplugin. - #1530: Added the possibility to use custom icons for buttons.
Other Changes:
- Updated SCAYT (Spell Check As You Type) and WebSpellChecker plugins:
- SCAYT
scayt_minWordLengthconfiguration option now defaults to 3 instead of 4. - SCAYT default number of suggested words in the context menu changed to 3.
- #90: Fixed: Selection is lost on link creation if SCAYT highlights the word.
- Fixed: SCAYT crashes when the browser
localStorageis disabled. - [IE11] Fixed:
Unable to get property type of undefined or null referenceerror in the browser console when SCAYT is disabled/enabled. - #46: Fixed: Editing is blocked when remote spell checker server is offline.
- Fixed: User Dictionary cannot be created in WSC due to
You already have the dictionaryerror. - Fixed: Words with apostrophe
'on the replacement make the WSC dialog inaccessible. - Fixed: SCAYT/WSC causes the
Uncaught TypeErrorerror in the browser console.
- SCAYT
- #1337: Updated the samples layout with the new CKEditor 4 logo and color scheme.
- #1591: CKBuilder and language tools are now downloaded over HTTPS. Thanks to August Detlefsen!
Important Notes:
-
#1249: Enabled the Upload Image plugin by default in standard and full presets. Also, it will no longer log an error in case of missing
config.imageUploadUrlproperty.
New Features:
- #933: Introduced Balloon Toolbar plugin.
- #662: Introduced image inlining for the Paste from Word plugin.
- #468: [Edge] Introduced support for the Clipboard API.
-
#607: Manually inserted Hex color is prefixed with a hash character (
#) if needed. It ensures a valid Hex color value is used when setting the table cell border or background color with the Color Dialog window. - #584: Font size and Family and Format drop-downs are not toggleable anymore. Default option to reset styles added.
-
#856: Introduced the
CKEDITOR.tools.keystrokeToArraymethod. It converts a keystroke into its string representation, returning every key name as a separate array element. -
#1053: Introduced the
CKEDITOR.tools.object.mergemethod. It allows to merge two objects, returning the new object with all properties from both objects deeply cloned. -
#1073: Introduced the
CKEDITOR.tools.array.everymethod. It invokes a given test function on every array element and returnstrueif all elements pass the test.
Fixed Issues:
- #796: Fixed: A list is pasted from OneNote in the reversed order.
- #834: [IE9-11] Fixed: The editor does not save the selected state of radio buttons inserted by the Form Elementsplugin.
- #704: [Edge] Fixed: Using Ctrl/Cmd + Z breaks widget structure.
- #591: Fixed: A column is inserted in a wrong order inside the table if any cell has a vertical split.
- #787: Fixed: Using Cut inside a nested table does not cut the selected content.
- #842: Fixed: List style not restored when toggling list indent level in the Indent List plugin.
- #711: Fixed: Dragging widgets should only work with the left mouse button.
- #862: Fixed: The "Object Styles" group in the Styles Combo plugin is visible only if the whole element is selected.
-
#994: Fixed: Typo in the
CKEDITOR.focusManager.focusAPI documentation. Thanks to benjy! - #1014: Fixed: The Table Tools Cell Properties dialog is now Advanced Content Filter aware — it is not possible to change the cell width or height if corresponding styles are disabled.
- #877: Fixed: A list with custom bullets with exotic characters crashes the editor when pasted from Word.
- #605: Fixed: Inline widgets do not preserve trailing spaces.
-
#1008: Fixed: Shorthand Hex colors from the
config.colorButton_colorsoption are not correctly highlighted in the Color Button Text Color or Background Color panel. -
#1094: Fixed: Widget definition
upcastmethods are called for every element. - #1057: Fixed: The Notification plugin overwrites Web Notifications API due to leakage to the global scope.
-
#1068: Fixed: Upload widget paste listener ignores changes to the
uploadWidgetDefinition. - #921: Fixed: [Edge] CKEditor erroneously perceives internal copy and paste as type "external".
- #1213: Fixed: Multiple images uploaded using Upload Image plugin are randomly duplicated or mangled.
- #532: Fixed: Removed an outdated user guide link from the About dialog.
-
#1221: Fixed: Invalid CSS loaded by Balloon Panel plugin when
config.skinis loaded using a custom path. - #522: Fixed: Widget selection is not removed when widget is inside table cell with Table Selection plugin enabled.
- #1027: Fixed: Cannot add multiple images to the table with Table Selection plugin in certain situations.
- #1069: Fixed: Wrong shape processing by Paste from Word plugin.
- #995: Fixed: Hyperlinked image gets inserted twice by Paste from Word plugin.
- #1287: Fixed: Widget plugin throws exception if included in editor build but not loaded into editor's instance.
API Changes:
-
#1097: Widget
upcastmethods are now called in the widget definition's context. -
#1118: Added the
showoption in theballoonPanel.attachmethod, allowing to attach a hidden Balloon Panelinstance. -
#1145: Added the
skipNotificationsoption to theCKEDITOR.fileTools.uploadWidgetDefinition, allowing to switch off default notifications displayed by upload widgets.
Other Changes:
New Features:
-
#568: Added possibility to adjust nested editables' filters using the
CKEDITOR.filter.disallowedContentproperty.
Fixed Issues:
-
#554: Fixed:
changeevent not fired when typing the first character after pasting into the editor. Thanks to Daniel Miller! -
#566: Fixed: The CSS
bordershorthand property with zero width (border: 0px solid #000;) causes the table to have the border attribute set to 1. - #779: Fixed: The Remove Format plugin removes elements with language definition inserted by the Languageplugin.
-
#423: Fixed: The Paste from Word plugin pastes paragraphs into the editor even if
CKEDITOR.config.enterModeis set toCKEDITOR.ENTER_BR. - #719: Fixed: Image inserted using the Enhanced Image plugin can be resized when the editor is in read-only mode.
- #577: Fixed: The "Delete Columns" command provided by the Table Tools plugin throws an error when trying to delete columns.
- #867: Fixed: Typing into a selected table throws an error.
- #817: Fixed: The Save plugin does not work in Source Mode.
Other Changes:
- Updated the WebSpellChecker plugin:
- #40: Fixed: IE10 throws an error when spell checking is started.
-
#800: Added the
CKEDITOR.dom.selection.isCollapsedmethod which is a simpler way to check if the selection is collapsed. -
#830: Added an option to define which dialog tab should be shown by default when creating
CKEDITOR.dialogCommand.
New Features:
- #455: Added Advanced Content Filter integration with the Justify plugin.
Fixed Issues:
-
#663: [Chrome] Fixed: Clicking the scrollbar throws an
Uncaught TypeError: element.is is not a functionerror. - #520: Fixed: Widgets cannot be properly pasted into a table cell.
-
#579: Fixed: Internal
cke_table-faked-selection-tableclass is visible in the Stylesheet Classes field of the Table Properties dialog. - #545: [Edge] Fixed: Error thrown when pressing the Select All button in Source Mode.
- #582: Fixed: Double slash in the path to stylesheet needed by the Table Selection plugin. Thanks to Marius Dumitru Florea!
- #491: Fixed: Unnecessary dependency on the Editor Toolbar plugin inside the Notification plugin.
- #646: Fixed: Error thrown into the browser console after opening the Styles Combo plugin menu in the editor without any selection.
- #501: Fixed: Double click does not open the dialog for modifying anchors inserted via the Link plugin.
- #9780: [IE8-9] Fixed: Clicking inside an empty read-only editor throws an error.
- #16820: [IE10] Fixed: Clicking below a single horizontal rule throws an error.
-
#426: Fixed: The
range.cloneContentsmethod selects the whole element when the selection starts at the beginning of that element. -
#644: Fixed: The
range.extractContentsmethod returns an incorrect result when multiple nodes are selected. -
#684: Fixed: The
elementPath.containsmethod incorrectly excludes the last element instead of root when thefromTopparameter is set totrue.
Other Changes:
- Updated the SCAYT (Spell Check As You Type) plugin:
- #148: Fixed: SCAYT leaves underlined word after the CKEditor Replace dialog corrects it.
-
#751: Added the
CKEDITOR.dom.nodeList.toArraymethod which returns an array representation of a node list.
New Features:
- Added a new Mexican Spanish localization. Thanks to David Alexandro Rodriguez!
- #413: Added Paste as Plain Text keyboard shortcut to the Accessibility Help instructions.
Fixed Issues:
- #515: [Chrome] Fixed: Mouse actions on CKEditor scrollbar throw an exception when the Table Selection plugin is loaded.
- #493: Fixed: Selection started from a nested table causes an error in the browser while scrolling down.
- #415: [Firefox] Fixed: Enter key breaks the table structure when pressed in a table selection.
- #457: Fixed: Error thrown when deleting content from the editor with no selection.
- #478: [Chrome] Fixed: Error thrown by the Enter Key plugin when pressing Enter with no selection.
- #424: Fixed: Error thrown by Tab Key Handling and Indent List plugins when pressing Tab with no selection in inline editor.
- #476: Fixed: Anchors inserted with the Link plugin on collapsed selection cannot be edited.
- #417: Fixed: The Table Resize plugin throws an error when used with a table with only header or footer rows.
-
#523: Fixed: The
editor.getCommandKeystrokemethod does not obtain the correct keystroke. - #534: [IE] Fixed: Paste from Word does not work in Quirks Mode.
-
#450: Fixed:
CKEDITOR.filterincorrectly transforms themarginCSS property.