You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{productname} {release-version} was released for {enterpriseversion} and {cloudname} on Wednesday, July 23^rd^, 2025. These release notes provide an overview of the changes for {productname} {release-version}, including:
This change improves consistency across commands and aligns with expected usage patterns in {productname} {release-version}.
645
646
646
-
=== Deprecated `editor.selection.setContent` API
647
-
// TINY-11692
647
+
=== Deprecated `fire()` method for event handling
648
+
// #TINY-12012
648
649
649
-
The `editor.selection.setContent` method has been deprecated in {productname} {release-version}. This low-level API was never intended for external use and does not guarantee consistent behavior when inserting complex content structures, such as lists. Integrators are advised to use the supported `editor.insertContent` method for reliable content insertion.
650
+
The `fire()` method was originally deprecated in {productname} 6 in favor of the `dispatch()` method for event handling, but was never removed from the codebase. {productname} {release-version} now displays a deprecation warning when the `fire()` method is used, serving as a final notice before its removal in {productname} 9.
650
651
651
-
This deprecation helps reduce confusion and aligns content insertion with {productname}'s supported APIs.
652
+
This long-overdue cleanup aligns the API with modern event handling conventions and removes confusion around method naming. Integrators should migrate to the `dispatch()` method to ensure compatibility with future releases.
652
653
654
+
.Deprecated approach for dispatching custom events
655
+
[source,javascript]
656
+
----
657
+
// Deprecated in TinyMCE 8, will be removed in 9
658
+
editor.fire('someEvent');
659
+
----
653
660
654
-
[[known-issues]]
655
-
== Known issues
661
+
.New approach for dispatching custom events
662
+
[source,javascript]
663
+
----
664
+
// Use dispatch() instead
665
+
editor.dispatch('someEvent');
666
+
----
656
667
657
-
This section describes issues that users of {productname} {release-version} may encounter and possible workarounds for these issues.
668
+
For more information on the `dispatch()` method, see: xref:apis/tinymce.util.eventdispatcher.adoc[EventDispatcher].
658
669
659
-
There <is one | are <number> known issue<s> in {productname} {release-version}.
670
+
=== Deprecated `editor.selection.setContent` API
671
+
// TINY-11692
660
672
661
-
// === <TINY-vwxyz 1 changelog entry>
662
-
// #TINY-vwxyz1
673
+
The `editor.selection.setContent` method has been deprecated in {productname} {release-version}. This low-level API was never intended for external use and does not guarantee consistent behavior when inserting complex content structures, such as lists. Integrators are advised to use the supported `editor.insertContent` method for reliable content insertion.
663
674
664
-
// CCFR here.
665
-
// **Status**: This issue is currently being investigated.
675
+
This deprecation helps reduce confusion and aligns content insertion with {productname}'s supported APIs.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/changelog.adoc
+25-9Lines changed: 25 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,21 +4,29 @@
4
4
5
5
NOTE: This is the {productname} Community version changelog. For information about the latest {cloudname} or {enterpriseversion} Release, see: xref:release-notes.adoc[{productname} Release Notes].
*Breaking Change in {productname} 8.0.0*: Users upgrading to {productname} {productmajorversion} with self-hosted commercial deployments must contact their account manager **to obtain new `T8LK:` prefixed license keys**. {productname} 7 license keys are not compatible with {productname} {productmajorversion} and cannot be modified to work by adding the `T8LK:` prefix. Cloud users ({cloudname}) are **not affected** as the commercial license is automatically applied. For complete details on the new license system and upgrade process, see: xref:license-key.adoc[License key configuration].
13
+
====
14
+
9
15
### Added
16
+
* Support for TinyMCE 8 xref:license-key.adoc[license keys] and license key manager.
17
+
// #TINY-12001
10
18
* New `pageUid` property on the `tinymce` global instance.
11
19
// #TINY-12021
12
20
* New `editorUid` property on editor instances.
13
21
// #TINY-12021
14
22
* New `UserLookup` API to provide consistent user management and fetching/caching user information across TinyMCE plugins.
15
23
// #TINY-11974
24
+
* New toolbar icons for suggested edits plugin.
25
+
// #TINY-12070
16
26
* New `crossorigin` option that sets the `crossorigin` attribute on scripts loaded by the editor.
17
27
// #TINY-12228
18
28
* New `allow_html_in_comments` option to allow HTML like contents inside comment data.
19
29
// #TINY-12220
20
-
* Support for TinyMCE 8 license keys and license key manager.
21
-
// #TINY-12001
22
30
* New `list_max_depth` option that limits the maximum list indent depth.
23
31
// #TINY-11937
24
32
@@ -37,26 +45,32 @@ NOTE: This is the {productname} Community version changelog. For information abo
37
45
// #TINY-12189
38
46
* When `editor.resetContent()` is used, the resulting `SetContent` event now has the `initial` flag set in the event arguments.
39
47
// #TINY-12146
40
-
* Updated Image plugin decorative image check to align with accessbility standard
48
+
* Updated Image plugin decorative image check to align with accessibility standard.
41
49
// #TINY-12545
42
50
43
51
### Changed
44
52
* DomParser no longer tries to fix some nodes when parsed with a context.
45
53
// #TINY-11927
46
54
* Split buttons are now rendered as separate action and chevron buttons.
47
55
// #TINY-8665
56
+
* Moved essential parts of the `lists` plugin into core.
57
+
// #TINY-12121
48
58
* Cut action now uses the editor delete implementation instead of the native `execCommand('Delete')` function.
49
59
// #TINY-12171
50
60
* Comments with HTML like content, attributes with HTML like values, elements with HTML Comment like textContent are no longer retained while content sanitization is active.
51
-
// #TINY-12056, see TINY-12220
61
+
// #TINY-12056
52
62
* Added space to promotion message for ease of reading.
53
63
// #TINY-12271
64
+
* Added deprecation console warning to `fire()` method.
65
+
// #TINY-12012
54
66
55
67
### Deprecated
56
68
* Deprecated `skipFocus` option for ToggleToolbarDrawer command. To skip focus use `skip_focus` option.
0 commit comments