Propriedade break-before do CSS

Definição e uso

A propriedade break-before determina se deve ocorrer quebra de página (page-break), quebra de coluna (column-break) ou quebra de região (region-break) antes do elemento especificado.

A propriedade break-before expande a propriedade page-break-before do CSS2.

Ao usar break-before, você pode informar ao navegador que deve interromper a página, a coluna ou a região antes do elemento onde a propriedade break-after é aplicada, ou evitar que o elemento seja dividido e espalhado em duas páginas.

Examples

Sempre insira um símbolo de quebra de página antes do elemento <h1>:

@media print {
  h1 {
    break-before: always;
  }
}

Sintaxe do CSS

break-before: auto|all|always|avoid|avoid-column|avoid-page|avoid-region|column|left|page|recto|region|right|verso|initial|inherit;

Property value

Value Description
auto Default. Automatically paginate, columnize, and regionize before the element.
all Always insert a page break immediately before the main frame.
always Always insert a page break (page-break) before the element.
avoid Avoid page, column, or region breaks before the element.
avoid-column Avoid inserting a column break before the element.
avoid-page Avoid inserting a page break before the element.
avoid-region Avoid inserting a region break before the element.
column Always insert a column break before the element.
left Insert one or two page breaks before the element to format the next page as a left page.
page Always insert a page break before the element.
recto Insert one or two page breaks before the main frame to format the next page as a recto page.
region Always insert a region-break before the element.
right Insert one or two page breaks before the element to format the next page as a right page.
verso Insert one or two page breaks before the main frame to format the next page as a verso page.
initial Sets this property to its default value. See initial.
inherit Inherits this property from its parent element. See inherit.

Technical details

Default value: auto
Inheritance: No
Animation production: Not supported. See:Animation-related properties.
Version: CSS3
JavaScript syntax: object.style.breakBefore="always"

More examples

Examples

To ensure that all new chapters start on the correct page (such as in a book), you can use break-before: on all <h1> elements:

@media print {
  h1 {
    break-before: right;
  }
}

Examples

Always insert a region-break: before the <ul> within the region:

.region ul {
    break-before: region;
  }
}

Browser support

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

Chrome IE / Edge Firefox Safari Opera
50.0 10.0 65.0 10.0 37.0