page-break-before
Quick Summary for page-break-before
break-before
property.
Code Usage for page-break-before
/* Keyword values */ page-break-before: auto; page-break-before: always; page-break-before: avoid; page-break-before: left; page-break-before: right; page-break-before: recto; page-break-before: verso; /* Global values */ page-break-before: inherit; page-break-before: initial; page-break-before: revert; page-break-before: unset;
More Details for page-break-before
page-break-before
Warning: This property has been replaced by the break-before
property.
The page-break-before
CSS property adjusts page breaks before the current element.
This property applies to block elements that generate a box. It won't apply on an empty <div>
that won't generate a box.
/* Keyword values */ page-break-before: auto; page-break-before: always; page-break-before: avoid; page-break-before: left; page-break-before: right; page-break-before: recto; page-break-before: verso; /* Global values */ page-break-before: inherit; page-break-before: initial; page-break-before: revert; page-break-before: unset;
Syntax
Values
auto
Initial value. Automatic page breaks (neither forced nor forbidden).
always
Always force page breaks before the element.
avoid
Avoid page breaks before the element.
left
Force page breaks before the element so that the next page is formatted as a left page.
right
Force page breaks before the element so that the next page is formatted as a right page.
recto
If pages progress left-to-right, then this acts like right
. If pages progress right-to-left, then this acts like left
.
verso
If pages progress left-to-right, then this acts like left
. If pages progress right-to-left, then this acts like right
.
Page break aliases
The page-break-before
property is now a legacy property, replaced by break-before
.
For compatibility reasons, page-break-before
should be treated by browsers as an alias of break-before
. This ensures that sites using page-break-before
continue to work as designed. A subset of values should be aliased as follows:
page-break-before | break-before |
---|---|
auto | auto |
left | left |
right | right |
avoid | avoid |
always | page |
Formal definition
Initial value | auto |
---|---|
Applies to | block-level elements in the normal flow of the root element. User agents may also apply it to other elements like table-row elements. |
Inherited | no |
Computed value | as specified |
Animation type | discrete |
Formal syntax
auto | always | avoid | left | right | recto | verso
Examples
Avoid a page break before an element
/* avoid page break before div elements of class note */ div.note { page-break-before: avoid; }
Specifications
Specification |
---|
CSS Logical Properties and Values Level 1 # page |
Proposals for the future of CSS Paged Media # page-break-before |
See also
break-before
, break-after
, break-inside
page-break-after
, page-break-inside
orphans
, widows
Last modified: Aug 12, 2021, by MDN contributors
Select your preferred language English (US)DeutschFrançais日本語Português (do Brasil) Change language