close

Filter

loading table of contents...

Release Notes / Version 11.2310

Table Of Contents

CoreMedia CKEditor 5 Plugins Updated

The CKEditor 5 Plugins provided by CoreMedia have been updated to 14.1.1.

This release addresses an issue that may occur while editing links within CKEditor 5: Having a link like:

<a xlink:href="https://e.org/" xlink:show="new">Link</a>

you may end up with mouse interaction or cursor movement, having a trailing (or leading) corrupted link like:

<a xlink:href="https://e.org/" xlink:show="new">Link</a><a xlink:href="" xlink:show="new"></a>

An update is recommended, as well as updating ckeditorDefault.ts to incorporate the required configuration (details below).

Details

The new release ships with a new plugin LinkAttributes, that allows to register attributes as "belonging to a link". Having this, such attributes share the same behavior as the "href" attribute, for example, like: Removed when "unlink" is invoked, share so-called two-step-caret-movement at the beginning and end of a link (decides, if newly typed text still belongs to the link or shall not be part of the link) and aligned focus management on mouse-click at end or beginning of link, which assumes to be "outside" of the link.

As part of this update, attributes that previously may have caused "links without or empty href" by the actions described above have been registered to be valid only in context of links. This applies to:

  • xlink:type: a fixed attribute, registered by the Rich Text Plugin.

  • xlink:actuate: represented as data-xlink-actuate in data view and editing view. Configured in ckeditorDefault.ts (see Upgrade Information below)

  • xlink:title represented as title in data view and editing view. Configured in ckeditorDefault.ts (see Upgrade Information below)

Upgrade Information

In @coremedia-blueprint/studio-client.ckeditor5 ckeditorDefault.ts has been adapted, so that xlink:title and xlink:actuate and its view representations title and data-xlink-actuate are considered valid only in context of links.

A constant linkAttributesConfig.ts defined in an extra file is included and the CKEditor 5 instance adapted in that way, that it uses LinkAttributes plugin and the provided configuration as part of the link feature configuration:

link: {
  defaultProtocol: 'https://',
  ...linkAttributesConfig,
},

If you provide editing support for xlink:title (view: title) and/or xlink:actuate (view: data-xlink-actuate) it is recommended to adapt linkAttributesConfig.ts by removing the corresponding attribute and integrate the configuration of LinkAttributes for this attribute to your plugin initialization.

Find more details in a new section in Studio Developer Manual CKEditor 5 Customization/Link Editing.

(CMS-22761)

Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.