New Features:
Fixed Issues:
- #1458: [Edge] Fixed: After blurring editor it takes 2 clicks to focus a widget.
- #1034: Fixed: JAWS leaves forms mode after pressing Enter key in an inline CKEditor instance.
- #1748: Fixed: Added missing
CKEDITOR.dialog.definition.onHide
API documentation. Thanks to sunnyone! - #1321: Ideographic space character
\u3000
is lost when pasting text. - #1776: Image Base empty caption placeholder is not hidden when blurred.
- #1592: Image Base caption is not visible after paste.
- #620: Fixed:
forcePasteAsPlainText
will be respected when internal and cross-editor pasting happen. - #1467: Fixed: Table Resize resizing coursor appearing in middle of merged cell.
API Changes:
- #1582: The
CKEDITOR.editor.addCommand
can acceptCKEDITOR.command
instance as parameter. - #1712:
extraPlugins
,removePlugins
andplugins
configuration options allow whitespace. - #1724: Added option to
getClientRect
function allowing to retrieve an absolute bounding rectangle of the element i.e. position relative to the upper-left corner of the topmost viewport. - #1498 : Added new method 'getClientRects()' to CKEDITOR.dom.range, which returns list of rects for each selected element.
Security Updates:
-
Fixed XSS vulnerability in the Enhanced Image (
image2
) plugin reported by Kyaw Min Thein.Issue summary: It was possible to execute XSS inside CKEditor using the
<img>
tag and specially crafted HTML. Please note that the default presets (Basic/Standard/Full) do not include this plugin, so you are only at risk if you made a custom build and enabled this plugin.
We would like to thank the Drupal security team for bringing this matter to our attention and coordinating the fix and release process!
Fixed Issues:
- #1835: Fixed: Integration between CKFinder and the File Browser plugin does not work.
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_requestHeaders
configuration option. - #1365: The File Browser plugin uses XHR requests by default.
- #1399: Added the possibility to set
CKEDITOR.config.startupFocus
asstart
orend
to 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.cssSelector
matcher. - #1232: Fixed: Balloon Toolbar buttons should be registered as focusable elements.
- #1342: Fixed: Balloon Toolbar should be re-positioned after the
change
event. - #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.forcePasteAsPlainText
option. - #1356: Fixed: Border parse function does not allow spaces in the color value.
- #1010: Fixed: The CSS
border
shorthand property was incorrectly expanded ignoring theborder-color
style. - #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.init
method of the requiring plugin. - #1530: Added the possibility to use custom icons for buttons.
Other Changes:
- Updated SCAYT (Spell Check As You Type) and WebSpellChecker (WSC) plugins:
- SCAYT
scayt_minWordLength
configuration 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
localStorage
is disabled. - [IE11] Fixed:
Unable to get property type of undefined or null reference
error 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 dictionary
error. - Fixed: Words with apostrophe
'
on the replacement make the WSC dialog inaccessible. - Fixed: SCAYT/WSC causes the
Uncaught TypeError
error 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.imageUploadUrl
property.
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.keystrokeToArray
method. It converts a keystroke into its string representation, returning every key name as a separate array element. - #1053: Introduced the
CKEDITOR.tools.object.merge
method. It allows to merge two objects, returning the new object with all properties from both objects deeply cloned. - #1073: Introduced the
CKEDITOR.tools.array.every
method. It invokes a given test function on every array element and returnstrue
if 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 Elements plugin.
- #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.focus
API 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_colors
option are not correctly highlighted in the Color Button Text Color or Background Color panel. - #1094: Fixed: Widget definition
upcast
methods 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.skin
is 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
upcast
methods are now called in the widget definition's context. - #1118: Added the
show
option in theballoonPanel.attach
method, allowing to attach a hidden Balloon Panel instance. - #1145: Added the
skipNotifications
option to theCKEDITOR.fileTools.uploadWidgetDefinition
, allowing to switch off default notifications displayed by upload widgets.
Other Changes:
- #815: Removed Node.js dependency from the CKEditor build script.
- #1041, #1131: Updated URLs pointing to CKSource and CKEditor resources after the launch of new websites.
New Features:
- #568: Added possibility to adjust nested editables' filters using the
CKEDITOR.filter.disallowedContent
property.
Fixed Issues:
- #554: Fixed:
change
event not fired when typing the first character after pasting into the editor. Thanks to Daniel Miller! - #566: Fixed: The CSS
border
shorthand 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 Language plugin.
- #423: Fixed: The Paste from Word plugin pastes paragraphs into the editor even if
CKEDITOR.config.enterMode
is 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.isCollapsed
method 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 function
error. - #694: Refactoring in the Table Selection plugin:
- #579: Fixed: Internal
cke_table-faked-selection-table
class 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.cloneContents
method selects the whole element when the selection starts at the beginning of that element. - #644: Fixed: The
range.extractContents
method returns an incorrect result when multiple nodes are selected. - #684: Fixed: The
elementPath.contains
method incorrectly excludes the last element instead of root when thefromTop
parameter 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.toArray
method 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.getCommandKeystroke
method does not obtain the correct keystroke. - #534: [IE] Fixed: Paste from Word does not work in Quirks Mode.
- #450: Fixed:
CKEDITOR.filter
incorrectly transforms themargin
CSS property.
Important Notes:
- #13793: The
embed_provider
configuration option for the Media Embed and Semantic Media Embed plugins is no longer preset by default. - The UI Color plugin now uses a custom color picker instead of the
YUI 2.7.0
library which has some known vulnerabilities (it's a security precaution, there was no security issue in CKEditor due to the way it was used).
New Features:
- #16755: Added the Table Selection plugin that lets you select and manipulate an arbitrary rectangular table fragment (a few cells, a row or a column).
- #16961: Added support for pasting from Microsoft Excel.
- #13381: Dynamic code evaluation call in
CKEDITOR.template
removed. CKEditor can now be used without theunsafe-eval
Content Security Policy. Thanks to Caridy Patiño! - #16971: Added support for color in the
background
property containing also other styles for table cells in the Table Tools plugin. - #16847: Added support for parsing and inlining any formatting created using the Microsoft Word style system to the Paste from Word plugin.
- #16818: Added table cell height parsing in the Paste from Word plugin.
- #16850: Added a new
config.enableContextMenu
configuration option for enabling and disabling the context menu. - #16937: The
command
parameter in CKEDITOR.editor.getCommandKeystroke now also accepts a command name as an argument. - #17010: The
CKEDITOR.dom.range.shrink
method now allows for skipping bogus<br>
elements.
Fixed Issues:
- #16935: [Chrome] Fixed: Blurring the editor in Source Mode throws an error.
- #16825: [Chrome] Fixed: Error thrown when destroying a focused inline editor.
- #16857: Fixed: Ctrl+Shift+V blocked by Copy Formatting.
- #16845: [IE] Fixed: Cursor jumps to the top of the scrolled editor after focusing it when the Copy Formatting plugin is enabled.
- #16786: Fixed: Added missing translations for the Copy Formatting plugin.
- #14714: [WebKit/Blink] Fixed: Exception thrown on refocusing a blurred inline editor.
- #16913: [Firefox, IE] Fixed: Paste as Plain Text keystroke does not work.
- #16968: Fixed: [Safari] Paste as Plain Text is not handled by the editor.
- #16912: Fixed: Exception thrown when a single image is pasted using Paste from Word.
- #16821: Fixed: Extraneous
<span>
elements withheight
style stacked when pasting from Word. - #16866: [IE, Edge] Fixed: Whitespaces not preserved when pasting from Word.
- #16860: Fixed: Paragraphs which only look like lists incorrectly transformed into them when pasting from Word.
- #16817: Fixed: When pasting from Word, paragraphs are transformed into lists with some corrupted data.
- #16833: [IE11] Fixed: Malformed list with headers pasted from Word.
- #16826: [IE] Fixed: Superfluous paragraphs within lists pasted from Word.
- #12465: Fixed: Cannot change the state of checkboxes or radio buttons if the properties dialog was invoked with a double-click.
- #13062: Fixed: Impossible to unlink when the caret is at the edge of the link.
- #13585: Fixed: Error when wrapping two adjacent
<div>
elements with a<div>
. - #16811: Fixed: Table alignment is not preserved by the Paste from Word plugin.
- #16810: Fixed: Vertical align in tables is not supported by the Paste from Word plugin.
- #11956: [Blink, IE] Fixed: Link dialog does not open on a double click on the second word of the link with a background color or other styles.
- #10472: Fixed: Unable to use Table Resize on table header and footer.
- #14762: Fixed: Hovering over an empty table (without rows or cells) throws an error when the Table Resize plugin is active.
- #16777: [Edge] Fixed: The Clipboard plugin does not allow to drop widgets into the editor.
- #14894: [Chrome] Fixed: The editor scrolls to the top after focusing or when a dialog is opened.
- #14769: Fixed: URLs with '-' in host are not detected by the Auto Link plugin.
- #16804: Fixed: Focus is not on the first menu item when the user opens a context menu or a drop-down list from the editor toolbar.
- #14407: [IE] Fixed: Non-editable widgets can be edited.
- #16927: Fixed: An error thrown if a bundle containing the Color Button plugin is run in ES5 strict mode. Thanks to Igor Rubinovich!
- #16920: Fixed: Several plugins not using the Dialog plugin as a direct dependency.
- PR#336: Fixed: Typo in
CKEDITOR.getCss
API documentation. Thanks to knusperpixel! - #17027: Fixed: Command event data should be initialized as an empty object.
- Fixed the behavior of HTML parser when parsing
src
/srcdoc
attributes of the<iframe>
element in a CKEditor setup with ACF turned off and without the Iframe Dialog plugin. The issue was originally reported as a security issue by Sriramk21 from Pegasystems and was later downgraded by the security team into a normal issue due to the requirement of having ACF turned off. Disabling Advanced Content Filter is against security best practices, so the problem described above has not been considered a security issue as such.
Other Changes:
- Updated SCAYT (Spell Check As You Type) and WebSpellChecker plugins:
- Fixed: DOM Exception after clicking "Remove Language" on a selected word with enabled Language plugin in SCAYT.
- #16958: Switched the default MathJax CDN provider for the Mathematical Formulas plugin from
cdn.mathjax.org
to cdnjs, due to closing ofcdn.mathjax.org
scheduled for April 30, 2017. - #16954: Removed the paste dialog.
- #16982: Latest Safari now supports enhanced Clipboard API introduced in CKEditor 4.5.0.
- #17025: Updated Bender.js to 0.4.2.
New Features:
- #16733: Added a new pastel color palette for the Color Button plugin and a new
config.colorButton_colorsPerRow
configuration option for setting the number of rows in the color selector. - #16752: Added a new Azerbaijani localization. Thanks to the Azerbaijani language team!
- #13818: It is now possible to group Widget style definitions, so applying one style disables the other.
Fixed Issues:
- #13446: [Chrome] Fixed: It is possible to type in an unfocused inline editor.
- #14856: Fixed: Font size and font family reset each other when modified at certain positions.
- #16745: [Edge] Fixed: List items are lost when pasted from Word.
- #16682: [Edge] Fixed: A list gets pasted from Word as a set of paragraphs. Added the
config.pasteFromWord_heuristicsEdgeList
configuration option. - #10373: Fixed: Context menu items can be dragged into the editor.
- #16728: [IE] Fixed: Copy Formatting breaks the editor in Quirks Mode.
- #16795: [IE] Fixed: Copy Formatting breaks the editor in Compatibility Mode.
- #16675: Fixed: Styles applied with Copy Formatting to a single table cell are applied to the whole table.
- #16753: Fixed:
element.setSize
sets incorrect editor dimensions if the border width is represented as a fraction of pixels. - #16705: [Firefox] Fixed: Unable to paste images as Base64 strings when using Clipboard.
- #14869: Fixed: JavaScript error is thrown when trying to use Find in a
<div>
-based editor.
New Features:
- #16639: The
callback
parameter in the CKEDITOR.ajax.post method became optional.
Fixed Issues:
- #11064: [Blink, WebKit] Fixed: Cannot select all editor content when a widget or a non-editable element is the first or last element of the content. Also fixes this issue in the Select All plugin.
- #14755: [Blink, WebKit, IE8] Fixed: Browser hangs when a table is inserted in the place of a selected list with an empty last item.
- #16624: Fixed: Improved the Color Button plugin which will now normalize the CSS
background
property if it only contains a color value. This fixes missing background colors when using Paste from Word. - #16600: [Blink, WebKit] Fixed: Error thrown occasionally by an uninitialized editable for multiple CKEditor instances on the same page.
New Features:
- #14569: Added a new, flat, default CKEditor skin called Moono-Lisa. Refreshed default colors available in the Color Button plugin (Text Color and Background Color feature).
- #14707: Added a new Copy Formatting feature to enable easy copying of styles between your document parts.
- Introduced the completely rewritten Paste from Word plugin:
- Backward incompatibility: The
config.pasteFromWordRemoveFontStyles
option now defaults tofalse
. This option will be deprecated in the future. Use Advanced Content Filter to replicate the effect of setting it totrue
. - Backward incompatibility: The
config.pasteFromWordNumberedHeadingToList
andconfig.pasteFromWordRemoveStyles
options were dropped and no longer have any effect on pasted content. - Major improvements in preservation of list numbering, styling and indentation (nested lists with multiple levels).
- Major improvements in document structure parsing that fix plenty of issues with distorted or missing content after paste.
- Backward incompatibility: The
- Added new translation: Occitan. Thanks to Cédric Valmary!
- #10015: Keyboard shortcuts (relevant to the operating system in use) will now be displayed in tooltips and context menus.
- #13794: The Upload Image feature now uses
uploaded.width/height
if set. - #12541: Added the Upload File plugin that lets you upload a file by drag&dropping it into the editor content.
- #14449: Introduced the Balloon Panel plugin that lets you create stylish floating UI elements for the editor.
- #12077: Added support for the HTML5
download
attribute in link (<a>
) elements. Selecting the "Force Download" checkbox in the Link dialog will cause the linked file to be downloaded automatically. Thanks to sbusse! - #13518: Introduced the
additionalRequestParameters
property for file uploads to make it possible to send additional information about the uploaded file to the server. - #14889: Added the
config.image2_altRequired
option for the Enhanced Image plugin to allow making alternative text a mandatory field. Thanks to Andrey Fedoseev!
Fixed Issues:
- #9991: Fixed: Paste from Word should only normalize input data.
- #7209: Fixed: Lists with 3 levels not pasted from Word correctly.
- #14335: Fixed: Pasting a numbered list starting with a value different from "1" from Microsoft Word does not work correctly.
- #14542: Fixed: Copying a numbered list from Microsoft Word does not preserve list formatting.
- #14544: Fixed: Copying a nested list from Microsoft Word results in an empty list.
- #14660: Fixed: Pasting text from Word breaks the styling in some cases.
- #14867: [Firefox] Fixed: Text gets stripped when pasting content from Word.
- #2507: Fixed: Paste from Word does not detect pasting a part of a paragraph.
- #3336: Fixed: Extra blank row added on top of the content pasted from Word.
- #6115: Fixed: When Right-to-Left text direction is applied to a table pasted from Word, borders are missing on one side.
- #6342: Fixed: Paste from Word filters out a basic text style when it is configured to use attributes.
- #6457: [IE] Fixed: Pasting from Word is extremely slow.
- #6789: Fixed: The
mso-list: ignore
style is not handled properly when pasting from Word. - #7262: Fixed: Lists in preformatted body disappear when pasting from Word.
- #7662: [Opera] Fixed: Extra empty number/bullet shown in the editor body when editing a multi-level list pasted from Word.
- #7807: Fixed: Last item in a list not converted to a
<li>
element after pasting from Word. - #7950: [IE] Fixed: Content from Word pasted differently than in other browsers.
- #7982: Fixed: Multi-level lists get split into smaller ones when pasting from Word.
- #8231: [WebKit, Opera] Fixed: Paste from Word inserts empty paragraphs.
- #8266: Fixed: Paste from Word inserts a blank line at the top.
- #8341, #7646: Fixed: Faulty removal of empty
<span>
elements in Paste from Word content cleanup breaking content formatting. - #8754: [Firefox] Fixed: Incorrect pasting of multiple nested lists in Paste from Word.
- #8983: Fixed: Alignment lost when pasting from Word with
config.enterMode
set toCKEDITOR.ENTER_BR
. - #9331: [IE] Fixed: Pasting text from Word creates a simple Caesar cipher.
- #9422: Fixed: Paste from Word leaves an unwanted
color:windowtext
style. - #10011: [IE9-10] Fixed:
config.pasteFromWordRemoveFontStyles
is ignored under certain conditions. - #10643: Fixed: Differences between using Ctrl+V and pasting from the Paste from Word dialog.
- #10784: Fixed: Lines missing when pasting from Word.
- #11294: [IE10] Fixed: Font size is not preserved when pasting from Word.
- #11627: Fixed: Missing words when pasting from Word.
- #12784: Fixed: Bulleted list with custom bullets gets changed to a numbered list when pasting from Word.
- #13174: Fixed: Data loss after pasting from Word.
- #13828: Fixed: Widget classes should be added to the wrapper rather than the widget element.
- #13829: Fixed: No class in Widget wrapper to identify the widget type.
- #13519: Server response received when uploading files should be more flexible.
Other Changes:
- Updated SCAYT (Spell Check As You Type) and WebSpellChecker plugins:
- Support for the new default Moono-Lisa skin.
- #121: Fixed: Basic Styles do not work when SCAYT is enabled.
- #125: Fixed: Inline styles are not continued when writing multiple lines of styled text with SCAYT enabled.
- #127: Fixed: Uncaught TypeError after enabling SCAYT in the CKEditor
<div>
element. - #128: Fixed: Error thrown after enabling SCAYT caused by conflicts with RequireJS.
Security Updates:
-
[Severity: minor] Fixed the
target="_blank"
vulnerability reported by James Gaskell.Issue summary: If a victim had access to a spoofed version of ckeditor.com via HTTP (e.g. due to DNS spoofing, using a hacked public network or mailicious hotspot), then when using a link to the ckeditor.com website it was possible for the attacker to change the current URL of the opening page, even if the opening page was protected with SSL.
An upgrade is recommended.
New Features:
- #14747: The Enhanced Image caption now supports the link
target
attribute. - #7154: Added support for the "Display Text" field to the Link dialog. Thanks to Ryan Guill!
Fixed Issues:
- #13362: [Blink, WebKit] Fixed: Active widget element is not cached when it is losing focus and it is inside an editable element.
- #13755: [Edge] Fixed: Pasting images does not work.
- #13548: [IE] Fixed: Clicking the elements path disables Cut and Copy icons.
- #13812: Fixed: When aborting file upload the placeholder for image is left.
- #14659: [Blink] Fixed: Content scrolled to the top after closing the dialog in a
<div>
-based editor. - #14825: [Edge] Fixed: Focusing the editor causes unwanted scrolling due to dropped support for the
setActive
method.
Fixed Issues:
- #10750: Fixed: The editor does not escape the
font-style
family property correctly, removing quotes and whitespace from font names. - #14413: Fixed: The Auto Grow plugin with the
config.autoGrow_onStartup
option set totrue
does not work properly for an editor that is not visible. - #14451: Fixed: Numeric element ID not escaped properly. Thanks to Jakub Chalupa!
- #14590: Fixed: Additional line break appearing after inline elements when switching modes. Thanks to dpidcock!
- #14539: Fixed: JAWS reads "selected Blank" instead of "selected " when selecting a widget.
- #14701: Fixed: More precise labels for Enhanced Image and Placeholder widgets.
- #14667: [IE] Fixed: Removing background color from selected text removes background color from the whole paragraph.
- #14252: [IE] Fixed: Styles drop-down list does not always reflect the current style of the text line.
- #14275: [IE9+] Fixed:
onerror
andonload
events are not used in browsers it could have been used when loading scripts dynamically.
Fixed Issues:
- #10685: Fixed: Unreadable toolbar icons after updating to the new editor version. Fixed with 6876179 in ckeditor-dev and 6c9189f4 in ckeditor-presets.
- #14573: Fixed: Missing Widget drag handler CSS when there are multiple editor instances.
- #14620: Fixed: Setting both the
min-height
style for the<body>
element and theheight
style for the<html>
element breaks the Auto Grow plugin. - #14538: Fixed: Keyboard focus goes into an embedded
<iframe>
element. - #14602: Fixed: The
dom.element.removeAttribute()
method does not remove all attributes if no parameter is given. - #8679: Fixed: Better focus indication and ability to style the selected color in the color picker dialog.
- #11697: Fixed: Content is replaced ignoring the letter case setting in the Find and Replace dialog window.
- #13886: Fixed: Invalid handling of the
CKEDITOR.style
instance with thestyles
property byCKEDITOR.filter
. - #14535: Fixed: CSS syntax corrections. Thanks to mdjdenormandie!
New Features:
- #12440: Added the
config.colorButton_enableAutomatic
option to allow hiding the "Automatic" option in the color picker.
Fixed Issues:
- #10448: Fixed: Lack of scrollbar in the right-to-left text direction.
- #12707: Fixed: The order of table elements does not comply with the HTML specification.
- #13756: [Edge] Fixed: Context menus are cut-off.
New Features:
- #14327: Added Swiss German localization. Thanks to Miro Grenda!
Fixed Issues:
- #13816: Introduced a new strategy for Filling Character handling to avoid changes in DOM. This fixes the following issues:
- #12727: [Blink]
IndexSizeError
when using the Div Editing Area and Content Templates plugins. - #13377: Widget plugin issue when typing in Korean.
- #13389: [Blink]
editor.getData()
fails when the cursor is next to an<hr>
tag. - #13513: [Blink, WebKit] Div Editing Area and
editor.getData()
throw an error when an image is the only data in the editor.
- #12727: [Blink]
- #13884: [Firefox] Fixed: Copying and pasting a table results in just the first cell being pasted.
- #14234: Fixed: URL input field is not marked as required in the Media Embed dialog.
New Features:
- Introduced the
CKEDITOR.tools.getCookie()
andCKEDITOR.tools.setCookie()
methods for accessing cookies. - Introduced the
CKEDITOR.tools.getCsrfToken()
method. The CSRF token is now automatically sent by the File Browser and File Tools plugins during file uploads. The server-side upload handlers may check it and use it to additionally secure the communication.
Other Changes:
- Updated SCAYT (Spell Check As You Type):
- New features:
- CKEditor Language plugin support.
- CKEditor Placeholder plugin support.
- Drag&Drop support.
- Experimental GRAYT (Grammar As You Type) functionality.
- Fixed issues:
- #98: SCAYT affects dialog double-click. Fixed in SCAYT core.
- #102: SCAYT core performance enhancements.
- #104: SCAYT's spans leak into the clipboard and after pasting.
- #105: A JavaScript error fired in case of multiple instances of CKEditor on one page.
- #107: SCAYT should not check non-editable parts of content.
- #108: Latest SCAYT copies the ID of the editor element to the iframe.
- SCAYT stops working when CKEditor Undo plugin not enabled.
- Issue with pasting SCAYT markup in CKEditor.
- SCAYT stops working after pressing the Cancel button in the WSC dialog.
- New features:
Fixed Issues:
- #13887: Fixed: Link plugin alters the
target
attribute value. Thanks to SamZiemer! - #12189: Fixed: The Link plugin dialog does not display the subject of email links if the subject parameter is not lowercase.
- #9192: Fixed: An
undefined
string is appended to an email address added with the Link plugin if subject and email body are empty andconfig.emailProtection
is set toencode
. - #13790: Fixed: It is not possible to destroy the editor
<iframe>
after the editor was detached from DOM. Thanks to Stefan Rijnhart! - #13803: Fixed: The editor cannot be destroyed before being fully initialized. Thanks to Cyril Fluck!
- #13867: Fixed: CKEditor does not work when the
classList
polyfill is used. - #13885: Fixed: Enhanced Image requires the Link plugin to link an image.
- #13883: Fixed: Copying a table using the context menu strips off styles.
- #13872: Fixed: Cutting is possible in the read-only mode.
- #12848: [Blink] Fixed: Opening the Find and Replace dialog window in the read-only mode throws an exception.
- #13879: Fixed: It is not possible to prevent the
editor.drop
event. - #13361: Fixed: Skin images fail when the site path includes parentheses because the
background-image
path needs single quotes around the URL value. - #13771: Fixed: The
contents.css
style is not used if the IFrame Editing Area plugin is missing. - #13782: Fixed: Unclear log messages.
- #13919: [Edge] Fixed: Browser window crashes when accessing the
isContentEditable
property of an<input>
DOM element.
Other Changes:
- #13859: Test cases created with
bender.tools.createTestsForEditors
will also receive editor bot as a second parameter.
New Features:
Fixed Issues:
- #9856: Fixed: Cannot use the native context menu together with the Div Editing Area plugin. Thanks to Mark Wade!
- #12733: [IE9+] Fixed: Radio button
onChange
does not work. Thanks to Iliya Kostadinov! - #13142: [Edge] Fixed: Ctrl+A and then Backspace result in an empty
<div>
element. - #13599: Fixed: Cross-editor drag and drop of an inline widget results in error/artifacts.
- #13640: [IE] Fixed: Dropping a widget outside the
<body>
element is not handled correctly. - #13533: Fixed: No progress during upload.
- #13680: Fixed: The parser should allow the
<h1-6>
element to be a child of the<summary>
element. - #11724: [Touch devices] Fixed: Drop-downs often hide right after opening them.
- #13690: Fixed: Copying content from IE to Chrome adds an extra paragraph.
- #13284: Fixed: Cannot drag and drop a widget if the text caret is placed just after the widget instance.
- #13516: Fixed: CKEditor removes empty HTML5 anchors without the
name
attribute. - #13765: [Safari 9] Fixed: Problems with rendering samples.
Other Changes:
- #11725: Marked
CKEDITOR.env.mobile
as deprecated. The reason is that it is no longer clear what "mobile" means. - #13737: Upgraded Bender.js to 0.4.1.
New Features:
- #13501: Added the
config.fileTools_defaultFileName
option to allow setting a default file name for paste uploads. - #13603: Added support for uploading dropped BMP images.
Fixed Issues:
- #13590: Fixed: Various issues related to the Paste from Word feature. Fixes also:
- #13386: [Edge] Fixed: Issues with selecting and editing images.
- #13568: Fixed: The
editor.getSelectedHtml()
method returns invalid results for entire content selection. - #13453: Fixed: Drag&drop of entire editor content throws an error.
- #13465: Fixed: Error is thrown and the widget is lost on drag&drop if it is the only content of the editor.
- #13414: Fixed: Content auto paragraphing in a nested editable despite editor configuration.
- #13429: Fixed: Incorrect selection after content insertion by the Auto Embed plugin.
- #13388: Fixed: Table Resize integration with Undo is broken.
Other Changes:
- #13637: Several icons were refactored.
- Updated Bender.js to 0.3.0 and introduced the ability to run tests via HTTPs (#13265).
Fixed Issues:
- #13609: [Edge] Fixed: The browser crashes when switching to the source mode. Thanks to Andrew Williams and Mark Smeed!
- PR#201: Fixed: Buttons in the toolbar configurator cause form submission. Thanks to colemanw!
- #13422: Fixed: A monospaced font should be used in the
<textarea>
element storing editor configuration in the toolbar configurator. - #13494: Fixed: Error thrown in the toolbar configurator if plugin requirements are not met.
- #13409: Fixed: List elements incorrectly merged when pressing Backspace or Delete.
- #13434: Fixed: Dialog state indicator broken in Right–To–Left environments.
- #13460: [IE8] Fixed: Copying inline widgets is broken when Advanced Content Filter is disabled.
- #13495: [Firefox, IE] Fixed: Text is not word-wrapped in the Paste dialog window.
- #13528: [Firefox@Windows] Fixed: Content copied from Microsoft Word and other external applications is pasted as a plain text. Removed the
CKEDITOR.plugins.clipboard.isHtmlInExternalDataTransfer
property as the check must be dynamic. - #13583: Fixed:
DataTransfer.getData()
should work consistently in all browsers and should not strip valuable content. Fixed pasting tables from Microsoft Excel on Chrome. - #13468: [IE] Fixed: Binding drag&drop
dataTransfer
does not work iftext
data was set in the meantime. - #13451: [IE8-9] Fixed: One drag&drop operation may affect following ones.
- #13184: Fixed: Web page reloaded after a drop on editor UI.
- #13129 Fixed: Block widget blurred after a drop followed by an undo.
- #13397: Fixed: Drag&drop of a widget inside its nested widget crashes the editor.
- #13385: Fixed:
editor.getSnapshot()
may return a non-string value. - #13419: Fixed: The Auto Link plugin does not encode double quotes in URLs.
- #13420: Fixed: The Auto Embed plugin ignores encoded characters in URL parameters.
- #13410: Fixed: Error thrown in the Auto Embed plugin when undoing right after pasting a link.
- #13566: Fixed: Suppressed notifications in the Media Embed Base plugin.
- #11616: [Chrome] Fixed: Resizing the editor while it is not displayed breaks the editable. Fixes also #9160 and #9715.
- #11376: [IE11] Fixed: Loss of text when pasting bulleted lists from Microsoft Word.
- #13143: [Edge] Fixed: Focus lost when opening the panel.
- #13387: [Edge] Fixed: "Permission denied" error thrown when loading the editor with developer tools open.
- #13574: [Edge] Fixed: "Permission denied" error thrown when opening editor dialog windows.
- #13441: [Edge] Fixed: The Clipboard plugin breaks the state of Undo commands after a paste.
- #13554: [Edge] Fixed: Paste dialog's iframe does not receive focus on show.
- #13440: [Edge] Fixed: Unable to paste a widget.
Other Changes:
- #13421: UX improvements to notifications in the Auto Embed plugin.
Fixed Issues:
- #13486: Fixed: The Upload Image plugin should log an error, not throw an error when upload URL is not set.
New Features:
- #13304: Added support for passing DOM elements to
config.sharedSpaces
. Thanks to Undergrounder! - #13215: Added ability to cancel fetching a resource by the Embed plugins.
- #13213: Added the
dialog#setState()
method and used it in the Embed dialog to indicate that a resource is being loaded. - #13337: Added the
repository.onWidget()
method — a convenient way to listen to widget events through the repository. - #13214: Added support for pasting links that convert into embeddable resources on the fly.
Fixed Issues:
- #13334: Fixed: Error after nesting widgets and playing with undo/redo.
- #13118: Fixed: The
editor.getSelectedHtml()
method throws an error when called in the source mode. - #13158: Fixed: Error after canceling a dialog when creating a widget.
- #13197: Fixed: Linked inline Enhanced Image alignment class is not transferred to the widget wrapper.
- #13199: Fixed: Semantic Embed does not support widget classes.
- #13003: Fixed: Anchors are uploaded when moving them by drag and drop.
- #13032: Fixed: When upload is done, notification update should be marked as important.
- #13300: Fixed: The
internalCommit
argument in the Image dialog seems to be never used. - #13036: Fixed: Notifications are moved 10px to the right.
- #13280: [IE8] Fixed: Undo after inline widget drag&drop throws an error.
- #13186: Fixed: Content dropped into a nested editable is not filtered by Advanced Content Filter.
- #13140: Fixed: Error thrown when dropping a block widget right after itself.
- #13176: [IE8] Fixed: Errors on drag&drop of embed widgets.
- #13015: Fixed: Dropping an image file on Enhanced Image causes a page reload.
- #13080: Fixed: Ugly notification shown when the response contains HTML content.
- #13011: [IE8] Fixed: Anchors are duplicated on drag&drop in specific locations.
- #13105: Fixed: Various issues related to
CKEDITOR.tools.htmlEncode()
andCKEDITOR.tools.htmlDecode()
methods. - #11976: [Chrome] Fixed: Copy&paste and drag&drop lists from Microsoft Word.
- #13128: Fixed: Various issues with cloning element IDs:
- Fixed the default behavior of
range.cloneContents()
andrange.extractContents()
methods which now clone IDs similarly to their native counterparts. - Added
cloneId
arguments to the above methods,range.splitBlock()
andelement.breakParent()
. Mind the default values and special behavior in theextractContents()
method! - Fixed issues where IDs were lost on copy&paste and drag&drop.
- Fixed the default behavior of
- Toolbar configurators:
- #13185: Fixed: Wrong position of the suggestion box if there is not enough space below the caret.
- #13138: Fixed: The "Toggle empty elements" button label is unclear.
- #13136: Fixed: Autocompleter is far too intrusive.
- #13133: Fixed: Tab leaves the editor.
- #13173: Fixed:
config.removeButtons
is ignored by the advanced toolbar configurator.
Other Changes:
- #13119: Improved compatibility of editor skins (Moono and Kama) with external web page style sheets.
- Toolbar configurators:
- #13316: Made
CKEDITOR.env.isCompatible
a blacklist rather than a whitelist. More about the change in the Browser Compatibility guide. - #13398: Renamed
CKEDITOR.fileTools.UploadsRepository
toCKEDITOR.fileTools.UploadRepository
and changed all related properties. - #13279: Reviewed CSS vendor prefixes.
- #13454: Removed unused
lang.image.alertUrl
token from the Image plugin.
New Features:
-
Clipboard (copy&paste, drag&drop) and file uploading features and improvements (#11437).
-
Major features:
- Support for dropping and pasting files into the editor was introduced. Through a set of new facades for native APIs it is now possible to easily intercept and process inserted files.
- File upload tools were introduced in order to simplify controlling the loading, uploading and handling server response, properly handle new upload configuration options, etc.
- Upload Image widget was introduced to upload dropped images. A base class for the upload widget was exposed, too, to make it simple to create new types of upload widgets which can handle any type of dropped file, show the upload progress and update the content when the process is done. It also handles editing and undo/redo operations when a file is being uploaded and integrates with the notification aggregator to show progress and success or error.
- All drag and drop operations were integrated with the editor. All dropped content is passed through the
editor#paste
event and a set of new editor events was introduced —dragstart
,drop
,dragend
. - The Data Transfer facade was introduced to unify access to data in various types and files. Data Transfer is now always available in the
editor#paste
event. - Switched from the pastebin to using the native clipboard access whenever possible. This solved many issues related to pastebin such as unnecessary scrolling or data loss. Additionally, on copy and cut from the editor the clipboard data is set. Therefore, on paste the editor has access to clean data, undisturbed by the browsers.
- Drag and drop of inline and block widgets was integrated with the standard clipboard APIs. By listening to drag events you will thus be notified about widgets, too. This opens a possibility to filter pasted and dropped widgets.
- The
editor#paste
event can have therange
parameter so it is possible to change the paste position in the listener or paste in the not selectable position. Also theeditor.insertHtml()
method now acceptsrange
as an additional parameter. - #11621: A configurable paste filter was introduced. The filter is by default turned to
'semantic-content'
on Webkit and Blink for all pasted content coming from external sources because of the low quality of HTML that these engines put into the clipboard. Internal and cross-editor paste is safe due to the change explained in the previous point.
-
Other changes and related fixes:
- #12095: On drag and copy of widgets the same method is used to get selected HTML as in the normal case. Thanks to that styles applied to inline widgets are not lost.
- #11219: Fixed: Dragging a captioned image does not fire the
editor#paste
event. - #9554: [Webkit Mac] Fixed: Editor scrolls on paste.
- #9898: [Webkit&Divarea] Fixed: Pasting causes undesirable scrolling.
- #11993: [Chrome] Fixed: Pasting content scrolls the document.
- #12613: Show the user that they can not drop on editor UI (toolbar, bottom bar).
- #12851: [Blink/Webkit] Fixed: Formatting disappears when pasting content into cells.
- #12914: Fixed: Copy/Paste of table broken in
div
-based editor.
-
Browser support.
Browser support for related features varies significantly (see http://caniuse.com/clipboard).- File APIs needed to operate and file upload is not supported in Internet Explorer 9 and below.
- Only Chrome and Safari on Mac OS support setting custom data items in the clipboard, so currently it is possible to recognize the origin of the copied content in these browsers only. All drag and drop operations can be identified thanks to the new Data Transfer facade.
- No Internet Explorer browser supports the standard clipboard API which results in small glitches like where only plain text can be dropped from outside the editor. Thanks to the new Data Transfer facade, internal and cross-editor drag and drop supports the full range of data.
- Direct access to clipboard could only be implemented in Chrome, Safari on Mac OS, Opera and Firefox. In other browsers the pastebin must still be used.
-
-
#12875: Samples and toolbar configuration tools.
- The old set of samples shipped with every CKEditor package was replaced with a shiny new single-page sample. This change concluded a long term plan which started from introducing the CKEditor SDK and CKEditor Functionality Overview section in the documentation which essentially redefined the old samples.
- Toolbar configurators with live previews were introduced. They will be shipped with every CKEditor package and are meant to help in configuring toolbar layouts.
-
#10925: The Media Embed and Semantic Media Embed plugins were introduced. Read more about the new features in the Embedding Content article.
-
#10931: Added support for nesting widgets. It is now possible to insert one widget into another widget's nested editable. Note that unless nested editable's allowed content is defined precisely, starting from CKEditor 4.5 some widget buttons may become enabled. This feature is not supported in IE8. Included issues:
- #12018: Fixed and reviewed: Nested widgets garbage collection.
- #12024: [Firefox] Fixed: Outline is extended to the left by unpositioned drag handlers.
- #12006: Fixed: Drag and drop of nested block widgets.
- #12008: Fixed various cases of inserting a single non-editable element using the
editor.insertHtml()
method. Fixes pasting a widget with a nested editable inside another widget's nested editable.
-
Notification system:
- #11580: Introduced the notification system.
- #12810: Introduced a notification aggregator for the notification system which simplifies displaying progress of many concurrent tasks.
-
#11636: Introduced new, UX-focused, methods for getting selected HTML and deleting it —
editor.getSelectedHtml()
andeditor.extractSelectedHtml()
. -
#12416: Added the
widget.definition.upcastPriority
property which gives more control over widget upcasting order to the widget author. -
#12036: Initialize the editor in read-only mode when the
<textarea>
element has areadonly
attribute. -
#11905: The
resize
event passes the current dimensions in its data. -
#12126: Introduced
config.image_prefillDimensions
andconfig.image2_prefillDimensions
to make pre-fillingwidth
andheight
configurable for the Enhanced Image. -
#12746: Added a new configuration option to hide the Enhanced Image resizer.
-
#12150: Exposed the
getNestedEditable()
andis*
widget helper functions (see the static methods). -
#12448: Introduced the
editable.insertHtmlIntoRange
method. -
#12143: Added the
config.floatSpacePreferRight
configuration option that switches the alignment of the floating toolbar. Thanks to InvisibleBacon! -
#10986: Added support for changing dialog input and textarea text directions by using the Shift+Alt+Home/End keystrokes. The direction is stored in the value of the input by prepending the
\u202A
or\u202B
marker to it. Read more in the documentation. Thanks to edithkk! -
#12770: Added support for passing widget's startup data as a widget command's argument. Thanks to Rebrov Boris and Tieme van Veen!
-
#11583: Added support for the HTML5
required
attribute in various form elements. Thanks to Steven Busse!
Changes:
- #12858: Basic Spartan browser compatibility. Full compatibility will be introduced later, because at the moment Spartan is still too unstable to be used for tests and we see many changes from version to version.
- #12948: The
config.mathJaxLibrary
option does not default to the MathJax CDN any more. It needs to be configured to enable the Mathematical Formulas plugin now. - #13069: Fixed inconsistencies between
editable.insertHtml()
andeditable.insertElement()
when therange
parameter is used. Now, theeditor.insertElement()
method works on a higher level, which means that it saves undo snapshots and sets the selection after insertion. Use theeditable.insertElementIntoRange()
method directly for the pre 4.5 behavior ofeditable.insertElement()
. - #12870: Use
editor.showNotification()
instead ofalert()
directly whenever possible. When the Notification plugin is loaded, the notification system is used automatically. Otherwise, the nativealert()
is displayed. - #8024: Swapped behavior of the Split Cell Vertically and Horizontally features of the Table Tools plugin to be more intuitive. Thanks to kevinisagit!
- #10903: Performance improvements for the
dom.element.addClass()
,dom.element.removeClass()
anddom.element.hasClass()
methods. Note: The previous implementation allowed passing multiple classes toaddClass()
although it was only a side effect of that implementation. The new implementation does not allow this. - #11856: The jQuery adapter throws a meaningful error if CKEditor or jQuery are not loaded.
Fixed issues:
- #11586: Fixed:
range.cloneContents()
should not change the DOM in order not to affect selection. - #12148: Fixed:
dom.element.getChild()
should not modify a passed array. - #12503: [Blink/Webkit] Fixed: Incorrect result of Select All and Backspace or Delete.
- #13001: [Firefox] Fixed: The
<br />
filler is placed in the wrong position by therange.fixBlock()
method due to quirky Firefox behavior. - #13101: [IE8] Fixed: Colons are prepended to HTML5 element names when cloning them.
Security Updates:
-
Fixed XSS vulnerability in the HTML parser reported by Dheeraj Joshi and Prem Kumar.
Issue summary: It was possible to execute XSS inside CKEditor after persuading the victim to: (i) switch CKEditor to source mode, then (ii) paste a specially crafted HTML code, prepared by the attacker, into the opened CKEditor source area, and (iii) switch back to WYSIWYG mode.
An upgrade is highly recommended!
Fixed Issues:
- #12899: Fixed: Corrected wrong tag ending for horizontal box definition in the Dialog User Interface plugin. Thanks to mizafish!
- #13254: Fixed: Cannot outdent block after indent when using the Div Editing Area plugin. Thanks to Jonathan Cottrill!
- #13268: Fixed: Documentation for
CKEDITOR.dom.text
is incorrect. Thanks to Ben Kiefer! - #12739: Fixed: Link loses inline styles when edited without the Advanced Tab for Dialogs plugin. Thanks to Віталій Крутько!
- #13292: Fixed: Protection pattern does not work in attribute in self-closing elements with no space before
/>
. Thanks to Віталій Крутько! - PR#192: Fixed: Variable name typo in the Dialog User Interface plugin which caused
CKEDITOR.ui.dialog.radio
validation to not work. Thanks to Florian Ludwig! - #13232: [Safari] Fixed: The
element.appendText()
method does not work properly for empty elements. - #13233: Fixed: HTMLDataProcessor can process
foo:href
attributes. - #12796: Fixed: The Indent List plugin unwraps parent
<li>
elements. Thanks to Andrew Stucki! - #12885: Added missing
editor.getData()
parameter documentation. - #11982: Fixed: Bullet added in a wrong position after the Enter key is pressed in a nested list.
- #13027: Fixed: Keyboard navigation in dialog windows with multiple tabs not following IBM CI 162 instructions or ARIA Authoring Practices.
- #12256: Fixed: Basic styles classes are lost when pasting from Microsoft Word if basic styles were configured to use classes.
- #12729: Fixed: Incorrect structure created when merging a block into a list item on Backspace and Delete.
- #13031: [Firefox] Fixed: No more line breaks in source view since Firefox 36.
- #13131: Fixed: The Code Snippet plugin cannot be used without the IFrame Editing Area plugin.
- #9086: Fixed: Invalid ARIA property used on paste area
<iframe>
. - #13164: Fixed: Error when inserting a hidden field.
- #13155: Fixed: Incorrect Line Utilities positioning when
<body>
has a margin. - #13351: Fixed: Link lost when editing a linked image with the Link tab disabled. This also fixed a bug when inserting an image into a fully selected link would throw an error (#12847).
- #13344: [WebKit/Blink] Fixed: It is possible to remove or change editor content in read-only mode.
Other Changes:
- #12844 and #13103: Upgraded the testing environment to Bender.js
0.2.3
. - #12930: Because of licensing issues,
truncated-mathjax/
is now removed from thetests/
directory. Nowbender.config.mathJaxLibPath
must be configured manually in order to run Mathematical Formulas plugin tests. - #13266: Added more shades of gray in the Color Dialog window. Thanks to mizafish!
Fixed Issues:
- #12825: Fixed: Preventing the Table Resize plugin from operating on elements outside the editor. Thanks to Paul Martin!
- #12157: Fixed: Lost text formatting on pressing Tab when the
config.tabSpaces
configuration option value was greater than zero. - #12777: Fixed: The
table-layout
CSS property should be reset by skins. Thanks to vita10gy! - #12812: Fixed: An uncaught security exception is thrown when Line Utilities are used in an inline editor loaded in a cross-domain
iframe
. Thanks to Vitaliy Zurian! - #12735: Fixed:
config.fillEmptyBlocks
should only apply when outputting data. - #10032: Fixed: Paste from Word filter is executed for every paste after using the button.
- #12597: [Blink/WebKit] Fixed: Multi-byte Japanese characters entry not working properly after Shift+Enter.
- #12387: Fixed: An error is thrown if a skin does not have the
chameleon
property defined andconfig.uiColor
is defined. - #12747: [IE8-10] Fixed: Opening a drop-down for a specific selection when the editor is maximized results in incorrect drop-down panel position.
- #12850: [IEQM] Fixed: An error is thrown after focusing the editor.
Security Updates:
-
Fixed XSS vulnerability in the HTML parser reported by Maco Cortes.
Issue summary: It was possible to execute XSS inside CKEditor after persuading the victim to: (i) switch CKEditor to source mode, then (ii) paste a specially crafted HTML code, prepared by the attacker, into the opened CKEditor source area, and (iii) switch back to WYSIWYG mode.
An upgrade is highly recommended!
New Features:
- #12501: Allowed dashes in element names in the string format of allowed content rules.
- #12550: Added the
<main>
element to theCKEDITOR.dtd
.
Fixed Issues:
- #12506: [Safari] Fixed: Cannot paste into inline editor if the page has
user-select: none
style. Thanks to shaohua! - #12683: Fixed: Filter fails to remove custom tags. Thanks to timselier!
- #12489 and #12491: Fixed: Various issues related to restoring the selection after performing operations on filler character. See the fixed cases.
- #12621: Fixed: Cannot remove inline styles (bold, italic, etc.) in empty lines.
- #12630: [Chrome] Fixed: Selection is placed outside the paragraph when the New Page button is clicked. This patch significantly simplified the way how the initial selection (a selection after the content of the editable is overwritten) is being fixed. That might have fixed many related scenarios in all browsers.
- #11647: Fixed: The
editor.blur
event is not fired on first blur after initializing the inline editor on an already focused element. - #12601: Fixed: Strikethrough button tooltip spelling.
- #12546: Fixed: The Preview tab in the Document Properties dialog window is always disabled.
- #12300: Fixed: The
editor.change
event fired on first navigation key press after typing. - #12141: Fixed: List items are lost when indenting a list item with content wrapped with a block element.
- #12515: Fixed: Cursor is in the wrong position when undoing after adding an image and typing some text.
- #12484: [Blink/WebKit] Fixed: DOM is changed outside the editor area in a certain case.
- #12688: Improved the tests of the styles system and fixed two minor issues.
- #12403: Fixed: Changing the font style should not lead to nesting it in the previous style element.
- #12609: Fixed: Incorrect
config.magicline_putEverywhere
name used for a Magic Line all-encompassingconfig.magicline_everywhere
configuration option.
New Features:
- #12279: Added a possibility to pass a custom evaluator to
node.getAscendant()
.
Fixed Issues:
- #12423: [Safari7.1+] Fixed: Enter key moved cursor to a strange position.
- #12381: [iOS] Fixed: Selection issue. Thanks to Remiremi!
- #10804: Fixed:
CKEDITOR_GETURL
is not used with some plugins where it should be used. Thanks to Thomas Andraschko! - #9137: Fixed: The
<base>
tag is not created when<head>
has an attribute. Thanks to naoki.fujikawa! - #12377: Fixed: Errors thrown in the Image plugin when removing preview from the dialog window definition. Thanks to Axinet!
- #12162: Fixed: Auto paragraphing and Enter key in nested editables.
- #12315: Fixed: Marked
config.autoParagraph
as deprecated. - #12113: Fixed: A code snippet should be presented in the elements path as "code snippet" (translatable).
- #12311: Fixed: Remove Format should also remove
<cite>
elements. - #12261: Fixed: Filter has to be destroyed and removed from
CKEDITOR.filter.instances
on editor destroy. - #12398: Fixed: Maximize does not work on an instance without a title.
- #12097: Fixed: JAWS not reading the number of options correctly in the Text Color and Background Color button menu.
- #12411: Fixed: Page Break used directly in the editable breaks the editor.
- #12354: Fixed: Various issues in undo manager when holding keys.
- #12324: [IE8] Fixed: Undo steps are not recorded when changing the caret position by clicking below the body.
- #12332: Fixed: Lowered DOM events listeners' priorities in undo manager in order to avoid ambiguity.
- #12402: [Blink] Fixed: Workaround for Blink bug with
document.title
which breaks updating title in the full HTML mode. - #12338: Fixed: The CKEditor package contains unoptimized images.
Fixed Issues:
- #12268: Cleanup of UI Color YUI styles. Thanks to CasherWest!
- #12263: Fixed: Paste from Word filter does not properly normalize semicolons style text. Thanks to Alin Purcaru!
- #12243: Fixed: Text formatting lost when pasting from Word. Thanks to Alin Purcaru!
- #111739: Fixed:
keypress
listeners should not be used in the undo manager. A complete rewrite of keyboard handling in the undo manager was made. Numerous smaller issues were fixed, among others:- #10926: [Chrome@Android] Fixed: Typing does not record snapshots and does not fire the
editor.change
event. - #11611: [Firefox] Fixed: The
editor.change
event is fired when pressing Arrow keys. - #12219: [Safari] Fixed: Some modifications of the
UndoManager.locked
property violate strict mode in the Undo plugin.
- #10926: [Chrome@Android] Fixed: Typing does not record snapshots and does not fire the
- #10916: Fixed: Magic Line icon in Right-To-Left environments.
- #11970: [IE] Fixed: CKEditor
paste
event is not fired when pasting with Shift+Ins. - #12111: Fixed: Linked image attributes are not read when opening the image dialog window by doubleclicking.
- #10030: [IE] Fixed: Prevented "Unspecified Error" thrown in various cases when IE8-9 does not allow access to
document.activeElement
. - #12273: Fixed: Applying block style in a description list breaks it.
- #12218: Fixed: Minor syntax issue in CSS files.
- #12178: [Blink/WebKit] Fixed: Iterator does not return the block if the selection is located at the end of it.
- #12185: [IE9QM] Fixed: Error thrown when moving the mouse over focused editor's scrollbar.
- #12215: Fixed: Basepath resolution does not recognize semicolon as a query separator.
- #12135: Fixed: Remove Format does not work on widgets.
- #12298: [IE11] Fixed: Clicking below
<body>
in Compatibility Mode will no longer reset selection to the first line. - #12204: Fixed: Editor's voice label is not affected by
config.title
. - #11915: Fixed: With SCAYT enabled, cursor moves to the beginning of the first highlighted, misspelled word after typing or pasting into the editor.
- SCAYT: Fixed: Error thrown in the console after enabling SCAYT and trying to add a new image.
Other Changes:
- #12296: Merged
benderjs-ckeditor
into the main CKEditor repository.
Security Updates:
- Fixed XSS vulnerability in the Preview plugin reported by Mario Heiderich of Cure53.
An upgrade is highly recommended!
New Features:
- #12164: Added the "Justify" option to the "Horizontal Alignment" drop-down in the Table Cell Properties dialog window.
Fixed Issues:
- #12110: Fixed: Editor crash after deleting a table. Thanks to Alin Purcaru!
- #11897: Fixed: Enter key used in an empty list item creates a new line instead of breaking the list. Thanks to noam-si!
- #12140: Fixed: Double-clicking linked widgets opens two dialog windows.
- #12132: Fixed: Image is inserted with
width
andheight
styles even when they are not allowed. - #9317: [IE] Fixed:
config.disableObjectResizing
does not work on IE. Note: We were not able to fix this issue on IE11+ because necessary events stopped working. See a last resort workaround and make sure to support our complaint to Microsoft. - #9638: Fixed: There should be no information about accessibility help available under the Alt+0 keyboard shortcut if the Accessibility Help plugin is not available.
- #8117 and #9186: Fixed: In HTML5
<meta>
tags should be allowed everywhere, including inside the<body>
element. - #10422: Fixed:
config.fillEmptyBlocks
not working properly if a function is specified.
Important Notes:
- The CKEditor testing environment is now publicly available. Read more about how to set up the environment and execute tests in the CKEditor Testing Environment guide.
Please note that the
tests/
directory which contains editor tests is not available in release packages. It can only be found in the development version of CKEditor on GitHub.
New Features:
- #11909: Introduced a parameter to prevent the
editor.setData()
method from recording undo snapshots.
Fixed Issues:
- #11757: Fixed: Imperfections in the Moono skin. Thanks to danyaPostfactum!
- #10091: Blockquote should be treated like an object by the styles system. Thanks to dan-james-deeson!
- #11478: Fixed: Issue with passing jQuery objects to adapter configuration.
- #10867: Fixed: Issue with setting encoded URI as image link.
- #11983: Fixed: Clicking a nested widget does not focus it. Additionally, performance of the
widget.repository.getByElement()
method was improved. - #12000: Fixed: Nested widgets should be initialized on
editor.setData()
andnestedEditable.setData()
. - #12022: Fixed: Outer widget's drag handler is not created at all if it has any nested widgets inside.
- #11960: [Blink/WebKit] Fixed: The caret should be scrolled into view on Backspace and Delete (covers only the merging blocks case).
- #11306: [OSX][Blink/WebKit] Fixed: No widget entries in the context menu on widget right-click.
- #11957: Fixed: Alignment labels in the Enhanced Image dialog window are not translated.
- #11980: [Blink/WebKit] Fixed:
<span>
elements created when joining adjacent elements (non-collapsed selection). - #12009: [Nested widgets] Integration with the Magic Line plugin.
- #11387: Fixed:
role="radiogroup"
should be applied only to radio inputs' container. - #7975: [IE8] Fixed: Errors when trying to select an empty table cell.
- #11947: [Firefox+IE11] Fixed: Shift+Enter in lists produces two line breaks.
- #11972: Fixed: Feature detection in the
element.setText()
method should not trigger the layout engine. - #7634: Fixed: The Flash Dialog plugin omits the
allowFullScreen
parameter in the editor data if set totrue
. - #11910: Fixed: Enhanced Image does not take
config.baseHref
into account when updating image dimensions. - #11753: Fixed: Wrong
checkDirty()
method value after focusing or blurring a widget. - #11830: Fixed: Impossible to pass some arguments to CKBuilder when using the
/dev/builder/build.sh
script. - #11945: Fixed: Form Elements plugin should not change a core method.
- #11384: [IE9+] Fixed:
IndexSizeError
thrown when pasting into a non-empty selection anchored in one text node.
New Features:
Fixed Issues:
- #11861: [WebKit/Blink] Fixed: Span elements created while joining adjacent elements. Note: This patch only covers cases when Backspace or Delete is pressed on a collapsed (empty) selection. The remaining case, with a non-empty selection, will be fixed in the next release.
- #10714: [iOS] Fixed: Selection and drop-downs are broken if a touch event listener is used due to a WebKit bug. Thanks to Arty Gus!
- #11911: Fixed setting the
dir
attribute for a preloaded language in CKEDITOR.lang. Thanks to Akash Mohapatra! - #11926: Fixed: Code Snippet does not decode HTML entities when loading code from the
<code>
element. - #11223: Fixed: Issue when Protected Source was not working in the
<title>
element. - #11859: Fixed: Removed the Source Dialog plugin dependency from the Code Snippet sample.
- #11754: [Chrome] Fixed: Infinite loop when content includes not closed attributes.
- #11848: [IE] Fixed:
editor.insertElement()
throwing an exception when there was no selection in the editor. - #11801: Fixed: Editor anchors unavailable when linking the Enhanced Image widget.
- #11626: Fixed: Table Resize sets invalid column width.
- #11872: Made
element.addClass()
chainable symmetrically toelement.removeClass()
. - #11813: Fixed: Link lost while pasting a captioned image and restoring an undo snapshot (Enhanced Image).
- #11814: Fixed: Link and Unlink entries persistently displayed in the Enhanced Image context menu.
- #11839: [IE9] Fixed: The caret jumps out of the editable area when resizing the editor in the source mode.
- #11822: [WebKit] Fixed: Editing anchors by double-click is broken in some cases.
- #11823: [IE8] Fixed: Table Resize throws an error over scrollbar.
- #11788: Fixed: It is not possible to change the language back to Not set in the Code Snippet dialog window.
- #11788: Fixed: Filter rules are not applied inside elements with the
contenteditable
attribute set totrue
. - #11798: Fixed: Inserting a non-editable element inside a table cell breaks the table.
- #11793: Fixed: Drop-down is not "on" when clicking it while the editor is blurred.
- #11850: Fixed: Fake objects with the
contenteditable
attribute set tofalse
are not downcasted properly. - #11811: Fixed: Widget's data is not encoded correctly when passed to an attribute.
- #11777: Fixed encoding ampersand in the Mathematical Formulas plugin.
- #11880: [IE8-9] Fixed: Linked image has a default thick border.
Other Changes:
- #11807: Updated jQuery version used in the sample to 1.11.0 and tested CKEditor jQuery Adapter with version 1.11.0 and 2.1.0.
- #9504: Stopped using deprecated
attribute.specified
in all browsers except Internet Explorer. - #11809: Changed tab size in
<pre>
to 4 spaces.
Important Notes:
- Marked the
editor.beforePaste
event as deprecated. - The default class of captioned images has changed to
image
(was:caption
). Please note that once edited in CKEditor 4.4+, all existing images of thecaption
class (<figure class="caption">
) will be filtered out unless theconfig.image2_captionedClass
option is set tocaption
. For backward compatibility (i.e. when upgrading), it is highly recommended to use this setting, which also helps prevent CSS conflicts, etc. This does not apply to new CKEditor integrations. - Widgets without defined buttons are no longer registered automatically to the Advanced Content Filter. Before CKEditor 4.4 widgets were registered to the ACF which was an incorrect behavior (#11567). This change should not have any impact on standard scenarios, but if your button does not execute the widget command, you need to set
allowedContent
andrequiredContent
properties for it manually, because the editor will not be able to find them. - The Show Borders plugin was added to the Standard installation package in order to ensure that unstyled tables are still visible for the user (#11665).
- Since CKEditor 4.4 the editor instance should be passed to
CKEDITOR.style
methods to ensure full compatibility with other features (e.g. applying styles to widgets requires that). We ensured backward compatibility though, so theCKEDITOR.style
will work even when the editor instance is not provided.
New Features:
- #11297: Styles can now be applied to widgets. The definition of a style which can be applied to a specific widget must contain two additional properties —
type
andwidget
. Read more in the Widget Styles section of the "Syles Drop-down" guide. Note that by default, widgets support only classes and no other attributes or styles. Related changes and features:- Introduced the
CKEDITOR.style.addCustomHandler()
method for registering custom style handlers. - The
CKEDITOR.style.apply()
andCKEDITOR.style.remove()
methods are now called with an editor instance instead of the document so they can be reused by theCKEDITOR.editor.applyStyle()
andCKEDITOR.editor.removeStyle()
methods. Backward compatibility was preserved, but from CKEditor 4.4 it is highly recommended to pass an editor instead of a document to these methods. - Many new methods and properties were introduced in the Widget API to make the handling of styles by widgets fully customizable. See:
widget.definition.styleableElements
,widget.definition.styleToAllowedContentRule
,widget.addClass()
,widget.removeClass()
,widget.getClasses()
,widget.hasClass()
,widget.applyStyle()
,widget.removeStyle()
,widget.checkStyleActive()
. - Integration with the Allowed Content Filter required an introduction of the
CKEDITOR.style.toAllowedContent()
method which can be implemented by the custom style handler and if exists, it is used by theCKEDITOR.filter
to translate a style to allowed content rules.
- Introduced the
- #11300: Various changes in the Enhanced Image plugin:
- Introduced the
config.image2_captionedClass
option to configure the class of captioned images. - Introduced the
config.image2_alignClasses
option to configure the way images are aligned with CSS classes. If this setting is defined, the editor produces classes instead of inline styles for aligned images. - Default image caption can be translated (customized) with the
editor.lang.image2.captionPlaceholder
string.
- Introduced the
- #11341: Enhanced Image plugin: It is now possible to add a link to any image type.
- #10202: Introduced wildcard support in the Allowed Content Rules format.
- #10276: Introduced blacklisting in the Allowed Content Filter.
- #10480: Introduced code snippets with code highlighting. There are two versions available so far — the default Code Snippet which uses the highlight.js library and the Code Snippet GeSHi which uses the GeSHi library.
- #11737: Introduced an option to prevent filtering of an element that matches custom criteria (see
filter.addElementCallback()
). - #11532: Introduced the
editor.addContentsCss()
method that can be used for adding custom CSS files. - #11536: Added the
CKEDITOR.tools.htmlDecode()
method for decoding HTML entities. - #11225: Introduced the
CKEDITOR.tools.transparentImageData
property which contains transparent image data to be used in CSS or as image source.
Other Changes:
- #11377: Unified internal representation of empty anchors using the fake objects.
- #11422: Removed Firefox 3.x, Internet Explorer 6 and Opera 12.x leftovers in code.
- #5217: Setting data (including switching between modes) creates a new undo snapshot. Besides that:
- Introduced the
editable.status
property. - Introduced a new
forceUpdate
option for theeditor.lockSnapshot
event. - Fixed: Selection not being unlocked in inline editor after setting data (#11500).
- Introduced the
- The WebSpellChecker plugin was updated to the latest version.
Fixed Issues:
- #10190: Fixed: Removing block style with
editor.removeStyle()
should result in a paragraph and not a div. - #11727: Fixed: The editor tries to select a non-editable image which was clicked.
New Features:
- Added new translation: Tatar.
Fixed Issues:
- #11677: Fixed: Undo/Redo keystrokes are blocked in the source mode.
- #11717: Document Properties plugin requires the Color Dialog plugin to work.
Fixed Issues:
- #11597: [IE11] Fixed: Error thrown when trying to open the preview using the keyboard.
- #11544: Placeholders will no longer be upcasted in parents not accepting
<span>
elements. - #8663: Fixed
element.renameNode()
not clearing theelement.getName()
cache. - #11574: Fixed: Backspace destroying the DOM structure if an inline editable is placed in a list item.
- #11603: Fixed: Table Resize attaches to tables outside the editable.
- #9205, #7805, #8216: Fixed:
{cke_protected_1}
appearing in data in various cases where HTML comments are placed next to"
or'
. - #11635: Fixed: Some attributes are not protected before the content is passed through the fix bin.
- #11660: [IE] Fixed: Table content is lost when some extra markup is inside the table.
- #11641: Fixed: Switching between modes in the classic editor removes content styles for the inline editor.
- #11568: Fixed: Styles drop-down list is not enabled on selection change.
Fixed Issues:
- #11500: [WebKit/Blink] Fixed: Selection lost when setting data in another inline editor. Additionally,
selection.removeAllRanges()
is now scoped to selection's root. - #11104: [IE] Fixed: Various issues with scrolling and selection when focusing widgets.
- #11487: Moving mouse over the Enhanced Image widget will no longer change the value returned by the
editor.checkDirty()
method. - #8673: [WebKit] Fixed: Cannot select and remove the Page Break.
- #11413: Fixed: Incorrect
editor.execCommand()
behavior. - #11438: Splitting table cells vertically is no longer changing table structure.
- #8899: Fixed: Links in the About CKEditor dialog window now open in a new browser window or tab.
- #11490: Fixed: Menu button panel not showing in the source mode.
- #11417: The
widget.doubleclick
event is not canceled anymore after editing was triggered. - #11253: [IE] Fixed: Clipped upload button in the Enhanced Image dialog window.
- #11359: Standardized the way anchors are discovered by the Link plugin.
- #11058: [IE8] Fixed: Error when deleting a table row.
- #11508: Fixed:
htmlDataProcessor
discovering protected attributes within other attributes' values. - #11533: Widgets: Avoid recurring upcasts if the DOM structure was modified during an upcast.
- #11400: Fixed: The
domObject.removeAllListeners()
method does not remove custom listeners completely. - #11493: Fixed: The
selection.getRanges()
method does not override cached ranges when used with theonlyEditables
argument. - #11390: [IE] All XML plugin methods now work in IE10+.
- #11542: [IE11] Fixed: Blurry toolbar icons when Right-to-Left UI language is set.
- #11504: Fixed: When
config.fullPage
is set totrue
, entities are not encoded in editor output. - #11004: Integrated Enhanced Image dialog window with Advanced Content Filter.
- #11439: Fixed: Properties get cloned in the Cell Properties dialog window if multiple cells are selected.
Fixed Issues:
- #11331: A menu button will have a changed label when selected instead of using the
aria-pressed
attribute. - #11177: Widget drag handler improvements:
- #11176: Fixed: Initial position is not updated when the widget data object is empty.
- #11001: Fixed: Multiple synchronous layout recalculations are caused by initial drag handler positioning causing performance issues.
- #11161: Fixed: Drag handler is not repositioned in various situations.
- #11281: Fixed: Drag handler and mask are duplicated after widget reinitialization.
- #11207: [Firefox] Fixed: Misplaced Enhanced Image resizer in the inline editor.
- #11102:
CKEDITOR.template
improvements: - #11121: [Firefox] Fixed: High Contrast mode is enabled when the editor is loaded in a hidden iframe.
- #11350: The default value of
config.contentsCss
is affected byCKEDITOR.getUrl()
. - #11097: Improved the Autogrow plugin performance when dealing with very big tables.
- #11290: Removed redundant code in the Source Dialog plugin.
- #11133: Page Break becomes editable if pasted.
- #11126: Fixed: Native Undo executed once the bottom of the snapshot stack is reached.
- #11131: Div Editing Area: Fixed: Error thrown when switching to source mode if the selection was in widget's nested editable.
- #11139: Div Editing Area: Fixed: Elements Path is not cleared after switching to source mode.
- #10778: Fixed a bug with range enlargement. The range no longer expands to visible whitespace.
- #11146: [IE] Fixed: Preview window switches Internet Explorer to Quirks Mode.
- #10762: [IE] Fixed: JavaScript code displayed in preview window's URL bar.
- #11186: Introduced the
widgets.repository.addUpcastCallback()
method that allows to block upcasting given element to a widget. - #11307: Fixed: Paste as Plain Text conflict with the MooTools library.
- #11140: [IE11] Fixed: Anchors are not draggable.
- #11379: Changed default contents
line-height
to unitless values to avoid huge text overlapping (like in #9696). - #10787: [Firefox] Fixed: Broken replacement of text while pasting into
div
-based editor. - #10884: Widgets integration with the Show Blocks plugin.
- #11021: Fixed: An error thrown when selecting entire editable contents while fake selection is on.
- #11086: [IE8] Re-enable inline widgets drag&drop in Internet Explorer 8.
- #11372: Widgets: Special characters encoded twice in nested editables.
- #10068: Fixed: Support for protocol-relative URLs.
- #11283: Enhanced Image: A
<div>
element withtext-align: center
and an image inside is not recognised correctly. - #11196: Accessibility Instructions: Allowed additional keyboard button labels to be translated in the dialog window.
Important Notes:
- To match the naming convention, the
language
button is nowLanguage
(#11201). - Enhanced Image button, context menu, command, and icon names match those of the Image plugin (#11222).
Fixed Issues:
- #11244: Changed: The
widget.repository.checkWidgets()
method now fires thewidget.repository.checkWidgets
event, so from CKEditor 4.3.1 it is preferred to use the method rather than fire the event. - #11171: Fixed:
editor.insertElement()
andeditor.insertText()
methods do not call thewidget.repository.checkWidgets()
method. - #11085: [IE8] Replaced preview generated by the Mathematical Formulas widget with a placeholder.
- #11044: Enhanced WAI-ARIA support for the Language plugin drop-down menu.
- #11075: With drop-down menu button focused, pressing the Down Arrow key will now open the menu and focus its first option.
- #11165: Fixed: The File Browser plugin cannot be removed from the editor.
- #11159: [IE9-10] Enhanced Image: Fixed buggy discovery of image dimensions.
- #11101: Drop-down lists no longer break when given double quotes.
- #11077: Enhanced Image: Empty undo step recorded when resizing the image.
- #10853: Enhanced Image: Widget has paragraph wrapper when de-captioning unaligned image.
- #11198: Widgets: Drag handler is not fully visible when an inline widget is in a heading.
- #11132: [Firefox] Fixed: Caret is lost after drag and drop of an inline widget.
- #11182: [IE10-11] Fixed: Editor crashes (IE11) or works with minor issues (IE10) if a page is loaded in Quirks Mode. See
env.quirks
for more details. - #11204: Added
figure
andfigcaption
styles to thecontents.css
file so Enhanced Image looks nicer. - #11202: Fixed: No newline in BBCode mode.
- #10890: Fixed: Error thrown when pressing the Delete key in a list item.
- #10055: [IE8-10] Fixed: Delete pressed on a selected image causes the browser to go back.
- #11183: Fixed: Inserting a horizontal rule or a table in multiple row selection causes a browser crash. Additionally, the
editor.insertElement()
method does not insert the element into every range of a selection any more. - #11042: Fixed: Selection made on an element containing a non-editable element was not auto faked.
- #11125: Fixed: Keyboard navigation through menu and drop-down items will now cycle.
- #11011: Fixed: The
editor.applyStyle()
method removes attributes from nested elements. - #11179: Fixed:
editor.destroy()
does not cleanup content generated by the Table Resize plugin for inline editors. - #11237: Fixed: Table border attribute value is deleted when pasting content from Microsoft Word.
- #11250: Fixed: HTML entities inside the
<textarea>
element are not encoded. - #11260: Fixed: Initially disabled buttons are not read by JAWS as disabled.
- #11200: Added Clipboard plugin as a dependency for Widget to fix drag and drop.
New Features:
- #10612: Internet Explorer 11 support.
- #10869: Widgets: Added better integration with the Elements Path plugin.
- #10886: Widgets: Added tooltip to the drag handle.
- #10933: Widgets: Introduced drag and drop of block widgets with the Line Utilities plugin.
- #10936: Widget System changes for easier integration with other dialog systems.
- #10895: Enhanced Image: Added file browser integration.
- #11002: Added the
draggable
option to disable drag and drop support for widgets. - #10937: Mathematical Formulas widget improvements:
- #10862: Placeholder plugin was rewritten as a widget.
- #10822: Added styles system integration with non-editable elements (for example widgets) and their nested editables. Styles cannot change non-editable content and are applied in nested editable only if allowed by its type and content filter.
- #10856: Menu buttons will now toggle the visibility of their panels when clicked multiple times. Language plugin fixes: Added active language highlighting, added an option to remove the language.
- #10028: New
config.dialog_noConfirmCancel
configuration option that eliminates the need to confirm closing of a dialog window when the user changed any of its fields. - #10848: Integrate remaining plugins (Styles, Format, Font, Color Button, Language and Indent) with active filter.
- #10855: Change the extension of emoticons in the BBCode sample from GIF to PNG.
Fixed Issues:
- #10831: Enhanced Image: Merged
image2inline
andimage2block
into oneimage2
widget. - #10835: Enhanced Image: Improved visibility of the resize handle.
- #10836: Enhanced Image: Preserve custom mouse cursor while resizing the image.
- #10939: [Firefox] Enhanced Image: hovering the image causes it to change.
- #10866: Fixed: Broken Tab key navigation in the Enhanced Image dialog window.
- #10833: Fixed: Lock ratio option should be on by default in the Enhanced Image dialog window.
- #10881: Various improvements to Enter key behavior in nested editables.
- #10879: Remove Format should not leak from a nested editable.
- #10877: Fixed: WebSpellChecker fails to apply changes if a nested editable was focused.
- #10877: Fixed: SCAYT blocks typing in nested editables.
- #11079: Add button icons to the Placeholder sample.
- #10870: The
paste
command is no longer being disabled when the clipboard is empty. - #10854: Fixed: Firefox prepends
<br>
to<body>
, so it is stripped by the HTML data processor. - #10823: Fixed: Link plugin does not work with non-editable content.
- #10828: Magic Line integration with the Widget System.
- #10865: Improved hiding copybin, so copying widgets works smoothly.
- #11066: Widget's private parts use CSS reset.
- #11027: Fixed: Block commands break on widgets; added the
contentDomInvalidated
event. - #10430: Resolve dependence of the Image plugin on the Form Elements plugin.
- #10911: Fixed: Browser Alt hotkeys will no longer be blocked while a widget is focused.
- #11082: Fixed: Selected widget is not copied or cut when using toolbar buttons or context menu.
- #11083: Fixed list and div element application to block widgets.
- #10887: Internet Explorer 8 compatibility issues related to the Widget System.
- #11074: Temporarily disabled inline widget drag and drop, because of seriously buggy native
range#moveToPoint
method. - #11098: Fixed: Wrong selection position after undoing widget drag and drop.
- #11110: Fixed: IFrame and Flash objects are being incorrectly pasted in certain conditions.
- #11129: Page break is lost when loading data.
- #11123: [Firefox] Widget is destroyed after being dragged outside of
<body>
. - #11124: Fixed the Elements Path in an editor using the Div Editing Area.
New Features:
- #9764: Widget System.
- Widget plugin introducing the Widget API.
- New
editor.enterMode
andeditor.shiftEnterMode
properties – normalized versions ofconfig.enterMode
andconfig.shiftEnterMode
. - Dynamic editor settings. Starting from CKEditor 4.3 Beta, Enter mode values and content filter instances may be changed dynamically (for example when the caret was placed in an element in which editor features should be adjusted). When you are implementing a new editor feature, you should base its behavior on dynamic or static Enter mode values depending on whether this feature works in selection context or globally on editor content.
- Dynamic Enter mode values –
editor.setActiveEnterMode()
method,editor.activeEnterModeChange
event, and two properties:editor.activeEnterMode
andeditor.activeShiftEnterMode
. - Dynamic content filter instances –
editor.setActiveFilter()
method,editor.activeFilterChange
event, andeditor.activeFilter
property.
- Dynamic Enter mode values –
- "Fake" selection was introduced. It makes it possible to virtually select any element when the real selection remains hidden. See the
selection.fake()
method. - Default
htmlParser.filter
rules are not applied to non-editable elements (elements withcontenteditable
attribute set tofalse
and their descendants) anymore. To add a rule which will be applied to all elements you need to pass an additional argument to thefilter.addRules()
method. - Dozens of new methods were introduced – most interesting ones:
- #10659: New Enhanced Image plugin that introduces a widget with integrated image captions, an option to center images, and dynamic "click and drag" resizing.
- #10664: New Mathematical Formulas plugin that introduces the MathJax widget.
- #7987: New Language plugin that implements Language toolbar button to support WCAG 3.1.2 Language of Parts.
- #10708: New smileys.
Fixed Issues:
- #10994: Fixed: Loading external jQuery library when opening the jQuery Adapter sample directly from file.
- #10975: [IE] Fixed: Error thrown while opening the color palette.
- #9929: [Blink/WebKit] Fixed: A non-breaking space is created once a character is deleted and a regular space is typed.
- #10963: Fixed: JAWS issue with the keyboard shortcut for Magic Line.
- #11096: Fixed: TypeError: Object has no method 'is'.
Fixed Issues:
- #9314: Fixed: Incorrect error message on closing a dialog window without saving changs.
- #10308: [IE10] Fixed: Unspecified error when deleting a row.
- #10945: [Chrome] Fixed: Clicking with a mouse inside the editor does not show the caret.
- #10912: Prevent default action when content of a non-editable link is clicked.
- #10913: Fixed
CKEDITOR.plugins.addExternal()
not handling paths including file name specified. - #10666: Fixed
CKEDITOR.tools.isArray()
not working cross frame. - #10910: [IE9] Fixed JavaScript error thrown in Compatibility Mode when clicking and/or typing in the editing area.
- #10868: [IE8] Prevent the browser from crashing when applying the Inline Quotation style.
- #10915: Fixed: Invalid CSS filter in the Kama skin.
- #10914: Plugins Indent List and Indent Block are now included in the build configuration.
- #10812: Fixed
range.createBookmark2()
incorrectly normalizing offsets. This bug was causing many issues: #10850, #10842. - #10951: Reviewed and optimized focus handling on panels (combo, menu buttons, color buttons, and context menu) to enhance accessibility. Fixed #10705, #10706 and #10707.
- #10704: Fixed a JAWS issue with the Select Color dialog window title not being announced.
- #10753: The floating toolbar in inline instances now has a dedicated accessibility label.
Fixed Issues:
- #10301: [IE9-10] Undo fails after 3+ consecutive paste actions with a JavaScript error.
- #10689: Save toolbar button saves only the first editor instance.
- #10368: Move language reading direction definition (
dir
) from main language file to core. - #9330: Fixed pasting anchors from MS Word.
- #8103: Fixed pasting nested lists from MS Word.
- #9958: [IE9] Pressing the "OK" button will trigger the
onbeforeunload
event in the popup dialog. - #10662: Fixed styles from the Styles drop-down list not registering to the ACF in case when the Shared Spaces plugin is used.
- #9654: Problems with Internet Explorer 10 Quirks Mode.
- #9816: Floating toolbar does not reposition vertically in several cases.
- #10646: Removing a selected sublist or nested table with Backspace/Delete removes the parent element.
- #10623: [WebKit] Page is scrolled when opening a drop-down list.
- #10004: [ChromeVox] Button names are not announced.
- #10731: WebSpellChecker plugin breaks cloning of editor configuration.
- It is now possible to set per instance WebSpellChecker plugin configuration instead of setting the configuration globally.
Important Notes:
-
Dropped compatibility support for Internet Explorer 7 and Firefox 3.6.
-
Both the Basic and the Standard distribution packages will not contain the new Indent Block plugin. Because of this the Advanced Content Filter might remove block indentations from existing contents. If you want to prevent this, either add an appropriate ACF rule to your filter or create a custom build based on the Basic/Standard package and add the Indent Block plugin in CKBuilder.
New Features:
- #10027: Separated list and block indentation into two plugins: Indent List and Indent Block.
- #8244: Use (Shift+)Tab to indent and outdent lists.
- #10281: The jQuery Adapter is now available. Several jQuery-related issues fixed: #8261, #9077, #8710, #8530, #9019, #6181, #7876, #6906.
- #10042: Introduced
config.title
setting to change the human-readable title of the editor. - #9794: Added
editor.change
event. - #9923: HiDPI support in the editor UI. HiDPI icons for Moono skin added.
- #8031: Handle
required
attributes on<textarea>
elements — introducededitor.required
event. - #10280: Ability to replace
<textarea>
elements with the inline editor.
Fixed Issues:
- #10599: Indent plugin is no longer required by the List plugin.
- #10370: Inconsistency in data events between framed and inline editors.
- #10438: [FF, IE] No selection is done on an editable element on executing
editor.setData()
.
New Features:
- Added new translation: Indonesian.
Fixed Issues:
- #10644: Fixed a critical bug when pasting plain text in Blink-based browsers.
- #5189: Find/Replace dialog window: rename "Cancel" button to "Close".
- #10562: [Housekeeping] Unified CSS gradient filter formats in the Moono skin.
- #10537: Advanced Content Filter should register a default rule for
config.shiftEnterMode
. - #10610:
CKEDITOR.dialog.addIframe()
incorrectly sets the iframe size in dialog windows.
New Features:
- Added new translation: Sinhala.
Fixed Issues:
- #10339: Fixed: Error thrown when inserted data was totally stripped out after filtering and processing.
- #10298: Fixed: Data processor breaks attributes containing protected parts.
- #10367: Fixed:
editable.insertText()
loses characters whenRegExp
replace controls are being inserted. - #10165: [IE] Access denied error when
document.domain
has been altered. - #9761: Update the Backspace key state in
keystrokeHandler.blockedKeystrokes
when callingeditor.setReadOnly()
. - #6504: Fixed: Race condition while loading several
config.customConfig
files. - #10146: [Firefox] Empty lines are being removed while
config.enterMode
isCKEDITOR.ENTER_BR
. - #10360: Fixed: ARIA
role="application"
should not be used for dialog windows. - #10361: Fixed: ARIA
role="application"
should not be used for floating panels. - #10510: Introduced unique voice labels to differentiate between different editor instances.
- #9945: [iOS] Scrolling not possible on iPad.
- #10389: Fixed: Invalid HTML in the "Text and Table" template.
- WebSpellChecker plugin user interface was changed to match CKEditor 4 style.
New Features:
- Added new translation: Albanian.
Fixed Issues:
- #10172: Pressing Delete or Backspace in an empty table cell moves the cursor to the next/previous cell.
- #10219: Error thrown when destroying an editor instance in parallel with a
mouseup
event. - #10265: Wrong loop type in the File Browser plugin.
- #10249: Wrong undo/redo states at start.
- #10268: Show Blocks does not recover after switching to Source view.
- #9995: HTML code in the
<textarea>
should not be modified by thehtmlDataProcessor
. - #10320: Justify plugin should add elements to Advanced Content Filter based on current Enter mode.
- #10260: Fixed: Advanced Content Filter blocks
tabSpaces
. Unifieddata-cke-*
attributes filtering. - #10315: [WebKit] Undo manager should not record snapshots after a filling character was added/removed.
- #10291: [WebKit] Space after a filling character should be secured.
- #10330: [WebKit] The filling character is not removed on
keydown
in specific cases. - #10285: Fixed: Styled text pasted from MS Word causes an infinite loop.
- #10131: Fixed:
undoManager.update()
does not refresh the command state. - #10337: Fixed: Unable to remove
<s>
using Remove Format.
Fixed Issues:
- #10192: Closing lists with the Enter key does not work with Advanced Content Filter in several cases.
- #10191: Fixed allowed content rules unification, so the
filter.allowedContent
property always contains rules in the same format. - #10224: Advanced Content Filter does not remove non-empty
<a>
elements anymore. - Minor issues in plugin integration with Advanced Content Filter:
- #10166: Added transformation from the
align
attribute tofloat
style to preserve backward compatibility after the introduction of Advanced Content Filter. - #10195: Image plugin no longer registers rules for links to Advanced Content Filter.
- #10213: Justify plugin is now correctly registering rules to Advanced Content Filter when
config.justifyClasses
is defined.
- #10166: Added transformation from the
New Features:
-
#9829: Advanced Content Filter - data and features activation based on editor configuration.
Brand new data filtering system that works in 2 modes:
- Based on loaded features (toolbar items, plugins) - the data will be filtered according to what the editor in its current configuration can handle.
- Based on
config.allowedContent
rules - the data will be filtered and the editor features (toolbar items, commands, keystrokes) will be enabled if they are allowed.
See the
datafiltering.html
sample, guides andCKEDITOR.filter
API documentation. -
#9387: Reintroduced Shared Spaces - the ability to display toolbar and bottom editor space in selected locations and to share them by different editor instances.
-
#9907: Added the
contentPreview
event for preview data manipulation. -
#9713: Introduced the Source Dialog plugin that brings raw HTML editing for inline editor instances.
-
Included in #9829: Introduced new events,
toHtml
andtoDataFormat
, allowing for better integration with data processing. -
#9981: Added ability to filter
htmlParser.fragment
,htmlParser.element
etc. by manyhtmlParser.filter
s before writing structure to an HTML string. -
Included in #10103:
- Introduced the
editor.status
property to make it easier to check the current status of the editor. - Default
command
state is nowCKEDITOR.TRISTATE_DISABLE
. It will be activated oneditor.instanceReady
or immediately after being added if the editor is already initialized.
- Introduced the
-
#9796: Introduced
<s>
as a default tag for strikethrough, which replaces obsolete<strike>
in HTML5.
Fixed Issues:
- #10196: Fixed context menus not opening with keyboard shortcuts when Autogrow is enabled.
- #10212: [IE7-10] Undo command throws errors after multiple switches between Source and WYSIWYG view.
- #10219: [Inline editor] Error thrown after calling
editor.destroy()
.
Fixed Issues:
- #9779: Fixed overriding
CKEDITOR.getUrl()
withCKEDITOR_GETURL
. - #9772: Custom buttons in the dialog window footer have different look and size (Moono, Kama skins).
- #9029: Custom styles added with the
stylesSet.add()
are displayed in the wrong order. - #9887: Disable Magic Line when
editor.readOnly
is set. - #9882: Fixed empty document title on
editor.getData()
if set via the Document Properties dialog window. - #9773: Fixed rendering problems with selection fields in the Kama skin.
- #9851: The
selectionChange
event is not fired when mouse selection ended outside editable. - #9903: [Inline editor] Bad positioning of floating space with page horizontal scroll.
- #9872:
editor.checkDirty()
returnstrue
when called onload. Removed the obsoleteeditor.mayBeDirty
flag. - #9893: [IE] Fixed broken toolbar when editing mixed direction content in Quirks mode.
- #9845: Fixed TAB navigation in the Link dialog window when the Anchor option is used and no anchors are available.
- #9883: Maximizing was making the entire page editable with divarea-based editors.
- #9940: [Firefox] Navigating back to a page with the editor was making the entire page editable.
- #9966: Fixed: Unable to type square brackets with French keyboard layout. Changed Magic Line keystrokes.
- #9507: [Firefox] Selection is moved before editable position when the editor is focused for the first time.
- #9947: [WebKit] Editor overflows parent container in some edge cases.
- #10105: Fixed: Broken sourcearea view when an RTL language is set.
- #10123: [WebKit] Fixed: Several dialog windows have broken layout since the latest WebKit release.
- #10152: Fixed: Invalid ARIA property used on menu items.
Fixed Issues:
- Security update: Added protection against XSS attack and possible path disclosure in the PHP sample.
Fixed Issues:
- #9655: Support for IE Quirks Mode in the new Moono skin.
- Accessibility issues (mainly in inline editor): #9364, #9368, #9369, #9370, #9541, #9543, #9841, #9844.
- Magic Line plugin:
- #9754: [WebKit] Cutting & pasting simple unformatted text generates an inline wrapper in WebKit browsers.
- #9456: [Chrome] Properly paste bullet list style from MS Word.
- #9699, #9758: Improved selection locking when selecting by dragging.
- Context menu:
- #9800: Hide float panel when resizing the window.
- #9721: Padding in content of div-based editor puts the editing area under the bottom UI space.
- #9528: Host page
box-sizing
style should not influence the editor UI elements. - #9503: Form Elements plugin adds context menu listeners only on supported input types. Added support for
tel
,email
,search
andurl
input types. - #9769: Improved floating toolbar positioning in a narrow window.
- #9875: Table dialog window does not populate width correctly.
- #8675: Deleting cells in a nested table removes the outer table cell.
- #9815: Cannot edit dialog window fields in an editor initialized in the jQuery UI modal dialog.
- #8888: CKEditor dialog windows do not show completely in a small window.
- #9360: [Inline editor] Blocks shown for a
<div>
element stay permanently even after the user exits editing the<div>
. - #9531: [Firefox & Inline editor] Toolbar is lost when closing the Format drop-down list by clicking its button.
- #9553: Table width incorrectly set when the
border-width
style is specified. - #9594: Cannot tab past CKEditor when it is in read-only mode.
- #9658: [IE9] Justify not working on selected images.
- #9686: Added missing contents styles for
<pre>
elements. - #9709: Paste from Word should not depend on configuration from other styles.
- #9726: Removed Color Dialog plugin dependency from Table Tools.
- #9765: Toolbar Collapse command documented incorrectly in the Accessibility Instructions dialog window.
- #9771: [WebKit & Opera] Fixed scrolling issues when pasting.
- #9787: [IE9]
onChange
is not fired for checkboxes in dialogs. - #9842: [Firefox 17] When opening a toolbar menu for the first time and pressing the Down Arrow key, focus goes to the next toolbar button instead of the menu options.
- #9847: Elements Path should not be initialized in the inline editor.
- #9853:
editor.addRemoveFormatFilter()
is exposed before it really works. - #8893: Value of the
pasteFromWordCleanupFile
configuration option is now taken from the instance configuration. - #9693: Removed "Live Preview" checkbox from UI color picker.
The first stable release of the new CKEditor 4 code line.
The CKEditor JavaScript API has been kept compatible with CKEditor 4, whenever possible. The list of relevant changes can be found in the API Changes page of the CKEditor 4 documentation.