diff --git a/modules/ROOT/pages/8.0-release-notes.adoc b/modules/ROOT/pages/8.0-release-notes.adoc index 5af99b20b7..6d6290756e 100644 --- a/modules/ROOT/pages/8.0-release-notes.adoc +++ b/modules/ROOT/pages/8.0-release-notes.adoc @@ -252,6 +252,34 @@ With the release of {productname} {release-version}, this issue has been resolve This change aligns better with modern standards and ensures that page breaks are now accurately rendered in exported documents. +=== The `pagebreak_split_block` option now defaults to `true`. When a page break is inserted, the resulting HTML output is: `
.` +// #TINY-12462 + +The default value for the `pagebreak_split_block` option has been changed from `false` to `true`. This change improves the user experience when inserting page breaks within block elements such as paragraphs, lists, or tables. When enabled: + +* Page breaks will automatically split the block element at the cursor position +* Content after the page break will be moved to a new block element of the same type +* The structure and formatting of the content is preserved on both sides of the page break + +For example, with this HTML content: + +[source,html] +---- +First page
+---- + +When placing the cursor after the word "First" and inserting a page break, the result will be: + +[source,html] +---- +First
+ +page
+---- + +This behavior is now enabled by default, but can be disabled by setting `pagebreak_split_block: false` in the editor configuration. + +For more information on the `pagebreak_split_block` option, see xref:pagebreak.adoc#pagebreak_split_block[pagebreak_split_block]. [[removed]] == Removed diff --git a/modules/ROOT/partials/configuration/pagebreak_split_block.adoc b/modules/ROOT/partials/configuration/pagebreak_split_block.adoc index 574bfcd124..44bbcb2446 100644 --- a/modules/ROOT/partials/configuration/pagebreak_split_block.adoc +++ b/modules/ROOT/partials/configuration/pagebreak_split_block.adoc @@ -1,11 +1,11 @@ [[pagebreak_split_block]] == `+pagebreak_split_block+` -When enabled this option makes it easier to split block elements with a page break. +By default, page breaks automatically split block elements (such as paragraphs, lists, or tables) at the cursor position while preserving the structure and formatting of the content. This option can be used to disable this behavior by setting it to `false` if this is undesired. *Type:* `+Boolean+` -*Default value:* `+false+` +*Default value:* `+true+` *Possible values:* `+true+`, `+false+` @@ -13,10 +13,11 @@ When enabled this option makes it easier to split block elements with a page bre [source,js] ---- +// Disable the block splitting behavior tinymce.init({ selector: 'textarea', // change this value according to your HTML plugins: 'pagebreak', toolbar: 'pagebreak', - pagebreak_split_block: true + pagebreak_split_block: false }); ----