CSS page-break-before Property
Topic: CSS3 Properties ReferencePrev|Next
Description
The page-break-before CSS property insert page breaks before an element when printing a document. This properties applies to block-level elements that generate a box. It won't apply on an empty <p> that won't generate a box.
The following table summarizes the usages context and the version history of this property.
| Default value: | auto |
|---|---|
| Applies to: | Block-level elements |
| Inherited: | No |
| Animatable: | No. See animatable properties. |
| Version: | CSS 2, 3 |
Syntax
The syntax of the property is given with:
The example below shows the page-break-before property in action.
Example
Try this code »@media print {
h1 {
page-break-before: always;
}
}The style rule in the above example sets the page-breaking behavior to always break the page before an <h1> element so that <h1> element always appears at the top of a new page.
Note: The page-break-before property only applicable to the block-level elements in the normal flow of the root element, or table-row elements.
Property Values
The following table describes the values of this property.
| Value | Description |
|---|---|
auto |
Insert a page break before the element, if necessary. This is default value. |
always |
Always force a page break before the element. |
avoid |
Avoid a page break before the element. |
left |
Forces either one or two page breaks before the element, so that the next page will be a left-hand page. |
right |
Forces either one or two page breaks before the element, so that the next page will be a right-hand page. |
initial |
Sets this property to its default value. |
inherit |
If specified, the associated element takes the computed value of its parent element page-break-before property. |
Browser Compatibility
The page-break-before property is partially supported in all major modern browsers.
 |
Basic Support—
|
Further Reading
See tutorial on: CSS Media Types.
Related properties: page-break-after, page-break-inside.
