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..
Tip: The properties: page-break-before, page-break-after and page-break-inside help to define how a document should behave when printed.
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: None of the browsers support "avoid".
Note: Browsers may interpret "left" and "right" as "always".
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
