CSS page-break-before Property
Example
Always insert a page break before each <h1> element (when printing):
@media print
{
h1 {page-break-before: always;}
}
Definition and Usage
The page-break-before property sets whether a page break should occur BEFORE a specified element.
Note: You cannot use this property on an empty <div> or on absolutely positioned elements.
| Default value: | auto |
|---|---|
| Inherited: | no |
| Animatable: | no. Read about animatable |
| Version: | CSS2 |
| JavaScript syntax: | object.style.pageBreakBefore="always" |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| page-break-before | 1.0 | 4.0 | 1.0 | 1.2 | 7.0 |
Note: Internet Explorer and Firefox do not support the property values "left" or "right".
CSS Syntax
page-break-before: auto|always|avoid|left|right|initial|inherit;
Property Values
| Value | Description |
|---|---|
| auto | Default. Automatic page breaks |
| always | Always insert a page break before the element |
| avoid | Avoid page break before the element (if possible) |
| left | Insert page breaks before the element so that the next page is formatted as a left page |
| right | Insert page breaks before the element so that the next page is formatted as a right page |
| initial | Sets this property to its default value. Read about initial |
| inherit | Inherits this property from its parent element. Read about inherit |
Related Pages
HTML DOM reference: pageBreakBefore property
