page-break-before

Article
10/10/2017

Sets a string indicating whether a page break occurs before the object.

Syntax

{ page-break-before: sBreak }

Possible values

sBreak

String that specifies one of the following values:

auto	Default. Neither force nor forbid a page break before the object.
always	Always insert a page break before the object.
empty string	Do not insert a page break.
left	Insert one or two page breaks before the object so that it begins at the top of the next left-hand page (in double-sided documents).
right	Insert one or two page breaks before the object so that it begins at the top of the next left-hand page (in double-sided documents).

The property has a default value of auto. It is not inherited.

Remarks

This property applies when printing the document. This property does not apply to the BR or HR elements.

If there are conflicts between the value of this property and the page-break-after property of the object previously displayed in the browser, the value that results in the largest number of page breaks is used.

Page breaks are not permitted inside positioned objects.

Examples

The following example uses the page-break-before property to start printing on a new page. This example uses the H3 element as a selector in an embedded style sheet to break the page before all H3 headings:

<style>
    h3 {page-break-before: always}
</style>
</head>
<body>
<h3>Start New Section on New Page</h3>

Standards information

This property is defined in Cascading Style Sheets (CSS), Level 2 (CSS2) Ee371245.xtlink_newWindow(en-us,Expression.40).png .

Applies to

address, blockquote, body, caption, center, dd, div, dl, dt, fieldset, form, hn, li, ol, p, table, tbody, td, tfoot, th, thead, tr, ul, xmp