This page is Not Ready

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

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

Initial value
:

Applies to
All elements
Inherited
No
Media
visual

Computed value
:

Animatable
No

CSS Object Model Property
:

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