Skip to content

Commit 2687102

Browse files
committed
DOC-2147: Add pagebreak_split_block breaking change.
1 parent a26208c commit 2687102

File tree

1 file changed

+25
-2
lines changed

1 file changed

+25
-2
lines changed

modules/ROOT/pages/migration-from-7x.adoc

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,10 @@ Any items marked **"High"** level require immediate attention during migration.
2323
|Self-hosted deployments now require a new license key format and license key manager. Old keys are **not compatible**.
2424
|High
2525
26+
|xref:pagebreak-split-block-default[pagebreak_split_block Default Value]
27+
|The default value changed from `false` to `true`, affecting how page breaks interact with block elements.
28+
|Medium
29+
2630
|xref:editor-selection-setcontent-deprecated[editor.selection.setContent] Deprecated
2731
|Method deprecated. Use `editor.insertContent` instead.
2832
|Medium
@@ -363,7 +367,7 @@ The Page Break plugin has been updated to work out-of-the-box with the xref:expo
363367

364368
**Migration steps:**
365369

366-
* If the old behavior is prefered, explicitly set the `pagebreak_separator` option:
370+
* If the old behavior is preferred, explicitly set the `pagebreak_separator` option:
367371

368372
[source, javascript]
369373
----
@@ -375,7 +379,26 @@ The default value has been changed to produce a page break in both the xref:expo
375379
.Example
376380
[source, javascript]
377381
----
378-
pagebreak_separator: '<div class="mce-pagebreak"></div>'
382+
pagebreak_separator: '<div style="break-after: page"></div>'
383+
----
384+
385+
==== `pagebreak_split_block` plugin option defualt has been updated
386+
// #TINY-12462
387+
388+
The default value of the xref:pagebreak.adoc#pagebreak_split_block[`pagebreak_split_block`] option has changed from `false` to `true`. This means that by default, inserting a page break will now automatically split block elements (such as paragraphs, lists, or tables) at the cursor position.
389+
390+
**Impact**: This change affects how page breaks interact with block elements, providing a more intuitive editing experience.
391+
392+
**Migration steps:**
393+
394+
* If you want to maintain the previous behavior where page breaks do not automatically split block elements, add the following to your configuration:
395+
396+
[source, javascript]
397+
----
398+
tinymce.init({
399+
// ...other configuration options...
400+
pagebreak_split_block: false
401+
});
379402
----
380403

381404
=== Technical Improvements and Cleanup

0 commit comments

Comments
 (0)