From f0fe427efb82106912ab7b4c86bbe1cc69492944 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Thu, 10 Jul 2025 12:48:29 +1000 Subject: [PATCH 1/5] DOC-3147: The default value of pagebreak_split_block is now true to match the new pagebreak_separator default. --- modules/ROOT/pages/8.0-release-notes.adoc | 27 +++++++++++++++++++ .../configuration/pagebreak_split_block.adoc | 7 ++--- 2 files changed, 31 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/8.0-release-notes.adoc b/modules/ROOT/pages/8.0-release-notes.adoc index 7c62f25b54..b14481ba41 100644 --- a/modules/ROOT/pages/8.0-release-notes.adoc +++ b/modules/ROOT/pages/8.0-release-notes.adoc @@ -125,7 +125,34 @@ For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-a // #TINY-vwxyz1 // CCFR here. +=== The default value of `pagebreak_split_block` is now `true` to match the new `pagebreak_separator` default +// #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

+

Second page

+---- + +When placing the cursor after the word "Second" and inserting a page break, the result will be: + +[source,html] +---- +

First page

+

Second

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 }); ---- From 42bd3186cdca9ee8625befdf34b3e75e9d5d779a Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Fri, 11 Jul 2025 08:46:23 +1000 Subject: [PATCH 2/5] Update modules/ROOT/pages/8.0-release-notes.adoc Co-authored-by: shirqa <43625458+ShiridiGandham@users.noreply.github.com> --- modules/ROOT/pages/8.0-release-notes.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/8.0-release-notes.adoc b/modules/ROOT/pages/8.0-release-notes.adoc index b14481ba41..b2cc51f2f3 100644 --- a/modules/ROOT/pages/8.0-release-notes.adoc +++ b/modules/ROOT/pages/8.0-release-notes.adoc @@ -142,12 +142,13 @@ For example, with this HTML content:

Second page

---- -When placing the cursor after the word "Second" and inserting a page break, the result will be: +When placing the cursor after the word "First page" and inserting a page break, the result will be: [source,html] ----

First page

-

Second

page

+
+

Second page

---- This behavior is now enabled by default, but can be disabled by setting `pagebreak_split_block: false` in the editor configuration. From f5bfec924be7dffdeb29660c14895245a2c6076a Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Fri, 11 Jul 2025 09:00:49 +1000 Subject: [PATCH 3/5] Update modules/ROOT/pages/8.0-release-notes.adoc Co-authored-by: shirqa <43625458+ShiridiGandham@users.noreply.github.com> --- modules/ROOT/pages/8.0-release-notes.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/8.0-release-notes.adoc b/modules/ROOT/pages/8.0-release-notes.adoc index b2cc51f2f3..cbd63b002c 100644 --- a/modules/ROOT/pages/8.0-release-notes.adoc +++ b/modules/ROOT/pages/8.0-release-notes.adoc @@ -125,7 +125,7 @@ For information on using Enhanced Skins & Icon Packs, see: xref:enhanced-skins-a // #TINY-vwxyz1 // CCFR here. -=== The default value of `pagebreak_split_block` is now `true` to match the new `pagebreak_separator` default +=== 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: From ba43f1e2630478d35d93fc27c4846e61fca74ec2 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 14 Jul 2025 12:55:20 +1000 Subject: [PATCH 4/5] Update modules/ROOT/pages/8.0-release-notes.adoc Co-authored-by: Hamza Benkhaldoun --- modules/ROOT/pages/8.0-release-notes.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/8.0-release-notes.adoc b/modules/ROOT/pages/8.0-release-notes.adoc index cbd63b002c..1d1cc02671 100644 --- a/modules/ROOT/pages/8.0-release-notes.adoc +++ b/modules/ROOT/pages/8.0-release-notes.adoc @@ -142,13 +142,13 @@ For example, with this HTML content:

Second page

---- -When placing the cursor after the word "First page" and inserting a page break, the result will be: +When placing the cursor after the word "First" and inserting a page break, the result will be: [source,html] ---- -

First page

+

First

-

Second page

+

page

---- This behavior is now enabled by default, but can be disabled by setting `pagebreak_split_block: false` in the editor configuration. From 89f2bccf8314d27db893100f4d146c60084bbd15 Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Mon, 14 Jul 2025 12:55:27 +1000 Subject: [PATCH 5/5] Update modules/ROOT/pages/8.0-release-notes.adoc Co-authored-by: Hamza Benkhaldoun --- modules/ROOT/pages/8.0-release-notes.adoc | 1 - 1 file changed, 1 deletion(-) diff --git a/modules/ROOT/pages/8.0-release-notes.adoc b/modules/ROOT/pages/8.0-release-notes.adoc index 1d1cc02671..3f6bc22c8c 100644 --- a/modules/ROOT/pages/8.0-release-notes.adoc +++ b/modules/ROOT/pages/8.0-release-notes.adoc @@ -139,7 +139,6 @@ For example, with this HTML content: [source,html] ----

First page

-

Second page

---- When placing the cursor after the word "First" and inserting a page break, the result will be: