page-break-before

Aviso: Esta propriedade foi substituída pela propriedade break-before.

A propriedade CSS page-break-before ajusta as "quebras de páginas" antes do elemento atual.

Esta propriedade aplica-se para elementos em bloco (block) que geram uma caixa. Não será aplicada em uma <div> vazia que não irá gerar uma caixa (box).

css
/* Keyword values */
page-break-before: auto;
page-break-before: always;
page-break-before: avoid;
page-break-before: left;
page-break-before: right;
page-break-before: recto;
page-break-before: verso;

/* Global values */
page-break-before: inherit;
page-break-before: initial;
page-break-before: unset;
Initial valueauto
Aplica-se ablock-level elements in the normal flow of the root element. User agents may also apply it to other elements like table-row elements.
Inheritednão
Computed valueas specified
Animation typediscrete

Page break aliases

A propriedade page-break-before agora é uma propriedade legada, substituída por break-before.

Por motivos de compatibilidade, page-break-before é tratada pelos navegadores como um alias de break-before. Isso garante que sites usando page-break-before continuem a funcionar. Um subconjunto de valores deve manter aliases como a seguir:

page-break-before break-before
auto auto
left left
right right
avoid avoid
always page

Syntax

Values

auto

Initial value. Automatic page breaks (neither forced nor forbidden).

always

Always force page breaks before the element.

avoid

Avoid page breaks before the element.

left

Force page breaks before the element so that the next page is formatted as a left page.

Force page breaks before the element so that the next page is formatted as a right page.

recto Experimental

If pages progress left-to-right, then this acts like right. If pages progress right-to-left, then this acts like left.

verso Experimental

If pages progress left-to-right, then this acts like left. If pages progress right-to-left, then this acts like right.

Formal syntax

page-break-before = 
auto |
always |
avoid |
left |
right |
inherit

Examples

css
/* avoid page break before the div */
div.note {
  page-break-before: avoid;
}

Especificações

Specification
CSS Logical Properties and Values Level 1
# page
CSS Paged Media Module Level 3
# page-break-before
CSS Fragmentation Module Level 3
# page-break-properties

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
page-break-before
Deprecated
always
Deprecated
auto
Deprecated
avoid
Deprecated
left
Deprecated
right
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.
See implementation notes.

See also