TinyMCE 5.8

Overview

TinyMCE 5.8 was released for TinyMCE Enterprise and Tiny Cloud on Wednesday, May 19th, 2021. It includes TinyMCE 5.8 and additional changes to premium plugins. These release notes provide an overview of the changes for TinyMCE 5.8, including:

This is the Tiny Cloud and TinyMCE Enterprise release notes. For information on the latest community version of TinyMCE, see: TinyMCE Changelog.

New features

The following new features were added for the TinyMCE 5.8 release.

Added new fixed_toolbar_container_target option

The new fixed_toolbar_container_target option allows the inline toolbar to be rendered in a specified HTMLElement, similar to the fixed_toolbar_container setting. This feature was contributed by pvrobays.

For information on the fixed_toolbar_container_target option, see User interface options - fixed_toolbar_container_target.

Added support for resizing the editor using the keyboard

Keyboard navigation can now be used to select the editor resize handle. Once it is selected, the arrow keys can be used to resize the editor.

For information on editor resizing, see: User interface options - Resize.

Additional new features

TinyMCE 5.8 introduces the following minor new features:

  • Added the PAGE_UP and PAGE_DOWN key code constants to the VK API.

Enhancements

The following enhancements were made for the TinyMCE 5.8 release.

Improved keyboard navigation for the inline boundary feature

Users can now escape inline elements (such as links and comments) using the Home, End, PageUp, and PageDown keys. Due to their unique behavior, PageUp and PageDown are not available in macOS.

For information on inline boundaries, see: Content appearance options - Inline boundaries.

Additional enhancements

TinyMCE 5.8 introduces the following minor enhancements:

  • Updated the formatter.matchFormat API to support matching formats with variables in the classes property.

  • Added HTML5 audio and video elements to the default alignment formats.

  • Added support for alpha list numbering to the list properties dialog.

Functionality changes

The following functionality changes were made for the TinyMCE 5.8 release:

  • Updated the image dialog to display the class list dropdown as full-width if the caption checkbox is not present.

  • Renamed the "H Align" and "V Align" input labels in the Table Cell Properties dialog to "Horizontal align" and "Vertical align" respectively.

Accompanying Premium Plugin changes

The following premium plugin updates were released alongside TinyMCE 5.8.

Accessibility Checker 2.3.2

The TinyMCE 5.8 release includes an accompanying release of the Accessibility Checker premium plugin.

Accessibility Checker 2.3.2 provides the following bug fixes:

  • Fixed an issue where the ordered list structure rule was not enforced when list items were separated by br elements.

  • Fixed an issue where adjacent links were not detected when separated by zero-width unicode characters.

  • Fixed an issue that could cause paragraphs that were used as headings to not be detected.

  • Fixed help documentation URLs pointing to old website locations.

  • Fixed dialog button text incorrectly using title-style capitalization.

For information on the Accessibility Checker plugin, see: Accessibility Checker plugin.

Comments 2.4.0

The TinyMCE 5.8 release includes an accompanying release of the Comments premium plugin.

This release adds new resolve conversation functionality, making it is possible for the user to perform an action which has another semantic meaning than that of deleting a conversation. It is up to the integrator to perform some additional action after a user has resolved a conversation.

Comments 2.4.0 provides the following new features:

For information on the Comments plugin, see: Comments plugin.

Export 1.0.0

The TinyMCE 5.8 release includes an accompanying release of the Export premium plugin.

Export 1.0.0 provides the following improvements:

  • Improved error handling when a PDF conversion failure occurs due to browser limitations.

  • Changed how image proxy errors are handled to gracefully fail and render a transparent image when an image proxy error occurs.

Export 1.0.0 provides the following bug fixes:

  • Fixed an issue where internal document links did not navigate within the client-side PDF exporter output.

For information on the Export plugin, see: Export plugin.

PowerPaste 5.5.0

The TinyMCE 5.8 release includes an accompanying release of the PowerPaste premium plugin.

This release adds support for copying and pasting content from Google Docs, making it possible to copy content and retain styles from Google Docs. By default, a dialog will appear asking users if the content should be cleaned or merged when pasting Google Docs content.

PowerPaste 5.5.0 provides the following new features:

PowerPaste 5.5.0 provides the following improvements:

  • The editor will now show a "loading" screen while paste events are processed.

PowerPaste 5.5.0 provides the following bug fixes:

  • Fixed an issue where automatic linking didn’t work with URLs containing commas in the path.

  • Fixed an issue where tables or images sometimes had negative left margins after being pasted.

  • Fixed an issue where it was possible for the width to be stripped from a table when pasted.

  • Fixed merge and clean dialog button text incorrectly using title-style capitalization.

For information on:

Spell Checker Pro 2.3.1

The TinyMCE 5.8 release includes an accompanying release of the Spell Checker Pro premium plugin.

Spell Checker Pro 2.3.1 provides the following bug fixes:

  • Fixed as-you-type spellchecking not running when editor content is changed programmatically.

  • Fixed English medical variants incorrectly falling back to regular English.

  • Fixed en_UK and en_BR incorrectly spellchecking as US English instead of UK English.

  • Fixed menu items sometimes not rendering as toggled due to language codes using a case sensitive comparison.

For information on the Spell Checker Pro plugin, see: Spell Checker Pro plugin.

Tiny Drive 1.4.0

The TinyMCE 5.8 release includes an accompanying release of Tiny Drive.

Tiny Drive 1.4.0 provides the following new features:

Tiny Drive 1.4.0 provides the following bug fixes:

  • Fixed a bug where images with exif orientation would be incorrectly oriented.

  • Fixed a bug where specifying 'audio' for the filetype setting would not list the files in the grid view.

  • Fixed a bug where tabbing though the user interface could throw an error.

For information on Tiny Drive, see: Tiny Drive.

Accompanying Premium Skins and Icon Packs changes

The TinyMCE 5.8 release includes an accompanying release of the Premium Skins and Icon Packs.

Premium Skins and Icon Packs - New features

A new Fluent skin and accompanying content css, which follows the Microsoft design language, is now available for TinyMCE.

For information on using premium skins and icon packs, see: Premium Skins and Icon Packs.

General bug fixes

TinyMCE 5.8 provides fixes for the following bugs:

  • Fixed a bug where it wasn’t possible to align nested list items.

  • The RGB fields in the color picker dialog were not staying in sync with the color palette and hue slider.

  • The color preview box in the color picker dialog was not correctly displaying the saturation and value of the chosen color.

  • The color picker dialog will now show an alert if it is submitted with an invalid hex color code.

  • Fixed a bug where the TableModified event was not fired when adding a table row with the Tab key.

  • Added missing images_file_types setting to the exported TypeScript types.

  • Fixed a bug where lists pasted from Word with Roman numeral markers were not displayed correctly. Patch contributed by aautio.

  • The editor.insertContent API was incorrectly handling nested span elements with matching styles.

  • The HTML5 small element could not be removed when clearing text formatting.

  • The Oxide button text transform variable was incorrectly using capitalize instead of none. Patch contributed by dakur.

  • Fix dialog button text that was using title-style capitalization.

  • Table plugin could perform operations on tables containing the inline editor.

  • Fixed Tab key navigation inside table cells with a ranged selection.

  • The foreground and background toolbar button color indicator is no longer blurry.

  • Fixed a regression in the tinymce.create() API that caused issues when multiple objects were created.

  • Fixed the LineHeight command causing the change event to be fired inconsistently.

Deprecated features

The following features have been deprecated with the release of TinyMCE 5.8:

The undocumented setIconStroke Split Toolbar Button API has been deprecated and will be removed in a future release.

Known issues

This section describes issues that users of TinyMCE 5.8 may encounter and possible workarounds for these issues.

Outline

Unexpected behavior when moving the caret using the PageDown and End keys

Issue: This issue affects moving the caret over links using the Page Down or End keys. If the caret is placed adjacent to a link and the key is pressed, the caret will move inside the link rather than past it.

Workaround: There was no known workaround at the time of the release.

Accessibility when using keyboard navigation to resize the editor

Issue: The editor can now be resized using keyboard navigation, however there is currently no available ARIA specification to indicate the resize state for screen readers or other assistive technology to consume.

Workaround: There was no known workaround at the time of the release. We are tracking the relevant ARIA GitHub issue for a way to support this.

Content pasted from Google Docs cannot be outdented

Issue: This issue affects content pasted in from Google Docs using the PowerPaste plugin. When content is pasted into the editor that contains indentation, it then cannot be outdented using the available toolbar buttons.

Workaround: The only known workaround is to configure TinyMCE to use margins instead of padding for indentation. This can be enabled by configuring the indent_use_margin option.

The configured skin is ignored for Tiny Drive in standalone mode

Issue: This issue prevents setting the skin for Tiny Drive in standalone mode using the skin option. This issue does not affect the tinydrive_skin option for the TinyMCE Tiny Drive plugin.

Workaround: There was no known workaround at the time of the release.

Upgrading to the latest version of TinyMCE 5

The procedure for upgrading to the latest version of TinyMCE 5 depends on the deployment type.

Upgrading Tiny Cloud

Tiny Cloud provides the latest enterprise version of TinyMCE. For information on configuring Tiny Cloud, see: the Cloud deployment guide.

Upgrading TinyMCE Self-hosted manually

To upgrade to TinyMCE 5.10 using a manually downloaded package:

  1. Backup the tinymce/ directory so any customizations can be restored after the upgrade.

    Customizations for TinyMCE are typically stored in the following directories:

    tinymce/
    ├── icons/
    ├── langs/
    ├── plugins/
    ├── skins/
    │   ├── content/
    │   └── ui/
    └── themes/
  2. Download the latest version of TinyMCE.

    • For the TinyMCE Community Version, download tinymce_<VERSION>.zip from Get TinyMCE - Self-hosted releases, where <VERSION> is the latest version of TinyMCE.

    • For the TinyMCE Enterprise Version, download the TinyMCE Enterprise Bundle from Tiny Account > Downloads. The downloaded file will be named enterprise_latest.zip.

  3. Extract the downloaded .zip file to a temporary location.

  4. (If required) Install the latest language packs from Get TinyMCE - Language Packages.

  5. Copy customizations to the new tinymce/ directory. Ensure that only custom changes are added the new tinymce/ directory, such as:

    • Custom icons packs

    • Custom plugins

    • Custom skins

    • Custom themes

  6. Delete the existing tinymce/ directory and replace with the new tinymce/.

To simplify the upgrade process to future versions of TinyMCE:

  1. Host the TinyMCE customizations outside of the tinymce/ directory.

  2. Update your TinyMCE configuration as required:

    • Set the location of content CSS customizations using content_css.

    • Set the location of custom plugins using external_plugins.

    • Set the location of custom icon packages using icons_url instead of icons.

    • Set the location of custom localization packages using language_url instead of language.

    • Set the location of custom skin packages using skin_url instead of skin.

    • Set the location of custom themes using theme_url instead of theme.