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.

/* 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.
right
Le saut de page est forcé avant l'élément afin que la prochaine page soit mise en forme comme une page droite.
recto This is an experimental API that should not be used in production code.
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 This is an experimental API that should not be used in production code.
Si la page progresse de gauche à droite, cette valeur est équivalente à left. Si la page progresse de droite à gauche, elle est synonyme de right.

Syntaxe formelle

auto | always | avoid | left | right | recto | verso

Exemples

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

Spécifications

Spécification État Commentaires
CSS Logical Properties and Values Level 1
La définition de 'recto and verso' dans cette spécification.
Brouillon de l'éditeur Ajout des valeurs recto et verso.
CSS Paged Media Module Level 3
La définition de 'page-break-before' dans cette spécification.
Version de travail Cette propriété peut désormais être étendues aux lignes de tableau et aux groupe de lignes de tableau.
CSS Level 2 (Revision 1)
La définition de 'page-break-before' dans cette spécification.
Recommendation Définition initiale.

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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi