page-break-before

Attention : Cette propriété a été remplacée par la propriété break-before.

La propriété CSS page-break-before permet d'ajuster les sauts de page placés avant l'élément courant.Cette propriété s'applique aux éléments de blocs qui génèrent une boîte. Elle ne s'appliquera pas à un <div> qui ne génère pas de boîte.

css
/* Valeurs avec un mot-clé */
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;

/* Valeurs globales */
page-break-before: inherit;
page-break-before: initial;
page-break-before: unset;

Synonymes avec break-before

La propriété page-break-before est désormais remplacée par break-before.

Pour des raisons de compatibilité, si on traite page-break-before comme un synonyme de break-before, on pourra utiliser le tableau de correspondance suivant :

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

Syntaxe

Valeurs

auto

Valeur initiale. Les sauts de page sont automatiques (ni forcés, ni interdits).

always

Le saut de page est toujours forcé avant l'élément.

avoid

Les sauts de page sont évités avant l'élément.

left

Le saut de page est forcé avant l'élément afin que la prochaine page soit mise en forme comme une page gauche.

Le saut de page est forcé avant l'élément afin que la prochaine page soit mise en forme comme une page droite.

recto Expérimental

Si la page progresse de gauche à droite, cette valeur est équivalente à right. Si la page progresse de droite à gauche, elle est synonyme de left.

verso Expérimental

Si la page progresse de gauche à droite, cette valeur est équivalente à left. Si la page progresse de droite à gauche, elle est synonyme de right.

Définition formelle

Valeur initialeauto
Applicabilitéles éléments de bloc dans le flux normal de l'élément racine. Les agents utilisateurs peuvent également l'appliquer sur d'autres éléments comme table-row.
Héritéenon
Valeur calculéecomme spécifié
Type d'animationdiscrète

Syntaxe formelle

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

Exemples

css
/* Pour éviter d'avoir un saut de page avant */
/* une note dans un div                      */
div.note {
  page-break-before: avoid;
}

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi