@ckeditor/ckeditor5-upload 38.1.0

on Node.js NPM

Release highlights

Show blocks

The show blocks feature allows the content creators to visualize all block-level elements (except for widgets) by surrounding them with an outline and displaying their element name at the top-left corner of the box.

Adjacent lists support

CKEditor 5 introduces an opt-in feature specifically for list handling during Word import or pasting. This feature influences how adjacent lists of the same type (either ordered or unordered) are processed. By default, such lists merge together, but you can prevent this.

To enable this feature, the AdjacentListsSupport plugin needs to be added to your CKEditor 5 configuration. This allows you to maintain distinct lists, even when they are of the same type and positioned adjacently. However, please note that this feature only works with the DocumentLists implementation. We are considering making it the default setting in future updates, based on user feedback and experience we collect. Let us know your opinion on the #14478 issue.

Comments archive integration guide

We released a new guide showcasing how you can customize comments archive UI to display the archive panel in a custom container, to better fit your application layout.

Fixing API scrolling integration with custom viewport offsets

We introduced a significant UX improvement that enhances the scrolling behavior of the Document Outline and Table of Contents features in the organization's documentation. Now, clicking on a heading in the Document Outline and Table of Contents displays a collapsed caret, which was previously located under the header section. Additionally, the fix improves other cases, such as proper scrolling when pressing enter while the editor is focused and scrolled away.

MINOR BREAKING CHANGES ℹ️

• html-support: The htmlAttributes model property has been replaced by html*Attributes, where the * represents the name of the view element. Clients will need to modify their code accordingly by replacing all instances of htmlAttributes with html*Attributes for the respective view elements.

Features

• export-word: Added support for resolved comment threads in the Export to Word feature.
• html-support: Changing a list type now removes styles inherited from the previous type. Closes #14216. (commit)
• list: Added the AdjacentListsSupport plugin to separate lists of the same type. Closes #12738. (commit)
• ui: BodyCollection.bodyCollectionContainer is now a public property. Closes #13928. (commit)

Bug fixes

• comments: The editor should no longer crash after resolving multiple comment threads from multiple editor instances inside one Context.
• document-outline: Fixed a randomly failing Table of Contents editing test (before each).
• document-outline: The document outline feature should respect the config.ui.viewportOffset configuration.
• engine: The editor should no longer crash while pressing backspace in an empty editor (in Firefox). Closes #14411, #14050. (commit)
• engine: Fixed the shallow view and model TreeWalkers returning elements outside of specified boundaries. (commit)
• engine: The CSS shorthand value normalizer should work for values with white spaces. Closes #14309. (commit)
• engine: View#scrollToTheSelection() should respect the config.ui.viewportOffset configuration and consider the geometry of a classic editor's toolbar to assure the caret is always visible to the user. Closes #13730. (commit)
• engine: Font attributes are preserved after inserting inline widgets. Closes #14106. (commit)
• export-pdf: Text will no longer go beyond its cell when columns are resized by the resize handler in exported PDFs. Closes #3355. (commit)
• font: The accept button in the color picker will no longer submit forms. Closes #14361. (commit)
• html-support: GHS should allow linking of custom elements. Closes #13803. (commit)
• html-support: Preserve HTML attributes when a list is split or its item is removed. Closes #14346 and #14349. (commit)
• html-support: Remove unrelated html*Attributes from elements. See #14216. (commit)
• mention: Multiple mentions in the last table cell should not result in a selection error. Closes #14025. (commit)
• paste-from-office: Remove the <style> tag that comes with the table pasted from Google Sheets. Closes #14131. (commit)
• paste-from-office: List markers should be displayed correctly after pasting a list from MS Word. Closes #12361. (commit)
• style: Styles dropdown should allow styling <div> elements. Closes #13341. (commit)
• table: Text will no longer go beyond its cell when columns are resized by resize handler in Firefox. Closes #14386. (commit)
• track-changes: Removed an unnecessary request to the token URL when using the TrackChangesData plugin.
• ui: Fixed a styling issue that would cause some toolbar dropdowns to be shrunk. (commit)
• ui: Fixed the arrow keys behavior in the color picker component. Closes #14218. (commit)
• ui: The "Powered by" logo should not shake on the first show. Closes cksource/ckeditor5-internal#3289. (commit)
• ui: Fixed the way code exports the colorPaletteIcon icon, which could result in a broken build. Closes #14205. (commit)
• utils: Rect#getVisible() should not consider ancestors when the target is an element with position: absolute. Closes #14107. (commit)
• Added multi-root support for: title, HTML comments, table resize, word count and block toolbar. (commit)
• Fixed editor crash that happened when TrackChangesData or revision history was used in setup with Context if CloudServices was set only in the Context configuration (and not in the editor configuration).

Other changes

• comments: The resolve button will now be disabled instead of hidden when the editor is in read-only mode for better UI consistency.
• engine: Exports ViewTreeWalker from ckeditor5-engine/src/index.ts. Closes #14158. (commit)
• html-support: Changed htmlAttributes to html*Attributes where * represents the name of the view element. See #14216. (commit)
• ui: Added a configuration option that forces the "Powered by" logo to show up despite a valid license key being used. Closes #14235. (commit)
• Optimized icons. (commit)
• Updated translations. (commit, commit)

Released packages

Check out the Versioning policy guide for more information.