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


Copyright 1999-2023 by Refsnes Data. All Rights Reserved.