page-break-before
Summary
The page-break-before property sets the page-breaking behavior before an element. With CSS3, page-break-* properties are only aliases of the break-* properties. The CSS3 Fragmentation spec defines breaks for all CSS box fragmentation.
Overview table
- Applies to
- All elements
- Inherited
- No
- Media
- visual
- Animatable
- No
Syntax
page-break-before: always
page-break-before: auto
page-break-before: avoid
page-break-before: empty string
page-break-before: inherit
page-break-before: left
page-break-before: right
Values
- auto
- Default. Insert a page break before the element if necessary.
- always
- Insert a page break before the element.
- avoid
- Avoid inserting a page break before the element.
- empty string
- Behaves the same as auto.
- left
- Insert page breaks before the element until it reaches a blank left page.
- right
- Insert page breaks before the element until it reaches a blank right page.
- inherit
- Specifies that the value of the page-break-before property should be inherited from the parent element
Related specifications
- CSS Fragmentation Module Level 3, 3.3. Page Break Aliases: the ‘page-break-before’, ‘page-break-after’, and ‘page-break-inside’ properties
- W3C Working Draft
- CSS Paged Media Module Level 3, 9. Page Breaks
- W3C Working Draft
- CSS Level 2 (Revision 1), 13.3.1 Page break properties: 'page-break-before’, 'page-break-after’, ‘page-break-inside’
- W3C Recommendation
Attributions
Microsoft Developer Network: [Windows Internet Explorer API reference Article]