Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions modules/ROOT/pages/8.0-release-notes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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: `<div style="break-after: page"></div>.`
// #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]
----
<p>First page</p>
----

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

[source,html]
----
<p>First </p>
<div style="break-after: page"></div>
<p>page</p>
----

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
Expand Down
Original file line number Diff line number Diff line change
@@ -1,22 +1,23 @@
[[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+`

=== Example: using `+pagebreak_split_block+`

[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
});
----