Clipboard (copy&paste, drag&drop) and file uploading features and improvements (#11437).
- 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.
- Image upload 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#pasteevent and a set of new editor events was introduced —
- The Data Transfer facade was introduced to unify access to data in various types and files. Data Transfer is now always available in the
- 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.
editor#pasteevent can have the
rangeparameter so it is possible to change the paste position in the listener or paste in the not selectable position. Also the
editor.insertHtml()method now accepts
rangeas 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
- #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
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.
#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.
#11636: Introduced new, UX-focused, methods for getting selected HTML and deleting it —
#12416: Added the
widget.definition.upcastPriorityproperty 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 a
resizeevent passes the current dimensions in its data.
config.image2_prefillDimensionsto make pre-filling
heightconfigurable for the Enhanced Image.
- #12746: Added a new configuration option to hide the Enhanced Image resizer.
#12150: Exposed the
is*widget helper functions (see the static methods).
#12448: Introduced the
#12143: Added the
config.floatSpacePreferRightconfiguration 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
\u202Bmarker 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
requiredattribute in various form elements. Thanks to Steven Busse!
- #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.
config.mathJaxLibraryoption does not default to the MathJax CDN any more. It needs to be configured to enable (http://ckeditor.com/cke4/addon/mathjax) plugin now.
#13069: Fixed inconsistencies between
rangeparameter is used. Now, the
editor.insertElement()method works on a higher level, what means that it saves undo snapshots and sets selection after insertion. Use the
editable.insertElementIntoRange()method directly for the pre 4.5.0 behavior of
alert()directly whenever possible. When the notification plugin is loaded the notifications system is used automatically. Otherwise, the native
- #8024: Swapped behavior of the Split Cell Vertically and Horizontally features to be more intuitive. Thanks to kevinisagit!
#10903: Performance improvements for the
dom.element.hasClass()methods. Note: The previous implementation allowed passing multiple classes to
addClass()although it was only a side effect of that implementation. The new implementation does not allow this.
- #11856: jQuery adapter throw a meaningful error if CKEditor or jQuery is not loaded.
range.cloneContents()should not change the DOM in order to not affect selection.
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 the
range.fixBlockmethod due to Firefox quirky behavior.
- #13101: [IE8] Fixed: IE8 prepends colons to HTML5 element names when cloning them.
- #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.tabSpacesconfiguration option value was greater than zero.
#12777: Fixed: The
table-layoutCSS 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!
config.fillEmptyBlocksshould 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
chameleonproperty defined and
- #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.
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!
- #12501: Allowed dashes in element names in the string format of allowed content rules.
#12550: Added the
<main>element to the
#12506: [Safari] Fixed: Cannot paste into inline editor if the page has
user-select: nonestyle. 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.blurevent 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.changeevent 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_putEverywherename used for a Magic Line all-encompassing
- #12423: [Safari7.1+] Fixed: Enter key moved cursor to a strange position.
- #12381: [iOS] Fixed: Selection issue. Thanks to Remiremi!
CKEDITOR_GETURLis 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
- #12113: Fixed: A code snippet should be presented in the elements path as "code snippet" (translatable).
#12311: Fixed: Remove Format should also remove
#12261: Fixed: Filter has to be destroyed and removed from
CKEDITOR.filter.instanceson 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.titlewhich breaks updating title in the full HTML mode.
- #12338: Fixed: The CKEditor package contains unoptimized images.
- #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!
keypresslisteners 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
#11611: [Firefox] Fixed: The
editor.changeevent is fired when pressing Arrow keys.
#12219: [Safari] Fixed: Some modifications of the
UndoManager.lockedproperty violate strict mode in the Undoplugin.
- #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
pasteevent 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
- #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
- #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.
benderjs-ckeditorinto the main CKEditor repository.