Atributo CSS page-break-before

Definition and usage

The page-break-before property sets the page-breaking behavior before the element.

Although it is possible to force a page break with always, it cannot be guaranteed to avoid the insertion of page breaks. Creators can at most request that the user agent try to avoid inserting page breaks as much as possible.

Applies to:Non-floating block-level elements with position values of relative or static.

Note:Use pagination attributes as little as possible and avoid using pagination attributes in tables, floating elements, and bordered block elements.

See also:

HTML DOM Reference Manual:pageBreakBefore attribute

Example

Set the pagination behavior after the table element to always perform pagination:

<html>
<head>
<style>
@media print
{
table {page-break-before:always;}
}
</style>
</head>
<body>
....
</body>
</html>

CSS syntax

page-break-before: auto|always|avoid|left|right|initial|inherit;

Attribute value

Value Description
auto Default value. 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.
left Sufficient page breaks before the element, until a blank left page.
right Sufficient page breaks before the element, until a blank right page.
inherit Specifies that the page-break-before property should be inherited from the parent element.

Technical details

Default value: auto
Inheritance: no
Version: CSS2
JavaScript syntax: object.style.pageBreakBefore="always"

Browser support

The numbers in the table indicate the first browser version that fully supports this attribute.

Chrome IE / Edge Firefox Safari Opera
1.0 4.0 1.0 1.2 7.0