page-break-after
Warning: This property has been replaced by the break-after
property.
The page-break-after
CSS property adjusts page breaks after the current element.
/* Keyword values */
page-break-after: auto;
page-break-after: always;
page-break-after: avoid;
page-break-after: left;
page-break-after: right;
page-break-after: recto;
page-break-after: verso;
/* Global values */
page-break-after: inherit;
page-break-after: initial;
page-break-after: revert;
page-break-after: unset;
This property applies to block elements that generate a box. It won't apply on an empty <div>
that won't generate a box.
Syntax
Values
auto
-
Initial value. Automatic page breaks (neither forced nor forbidden).
always
-
Always force page breaks after the element.
avoid
-
Avoid page breaks after the element.
left
-
Force page breaks after the element so that the next page is formatted as a left page.
right
-
Force page breaks after 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 likeleft
. verso
-
If pages progress left-to-right, then this acts like
left
. If pages progress right-to-left, then this acts likeright
.
Page break aliases
The page-break-after
property is now a legacy property, replaced by break-after
.
For compatibility reasons, page-break-after
should be treated by browsers as an alias of break-after
. This ensures that sites using page-break-after
continue to work as designed. A subset of values should be aliased as follows:
page-break-after | break-after |
---|---|
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
Examples
Setting a page break after footnotes
/* move to a new page after footnotes */
div.footnotes {
page-break-after: always;
}
Specifications
Specification |
---|
CSS Logical Properties and Values Level 1 # page |
Proposals for the future of CSS Paged Media # page-break-after |
Browser compatibility
BCD tables only load in the browser