CSS page-break-before Property
Example
Always insert a page-break before a <h1> element:
@media print
{
h1 {page-break-before: always;}
}
Definition and Usage
The page-break-before property adds a
page-break before a specified element.
Note: This property is replaced by the
break-before
property!
| 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 |
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-break before the element so that the next page is formatted as a left page |
| right | Insert page-break 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
