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: 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: 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 initiale	`auto`
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ée	non
Valeur calculée	comme spécifié
Type d'animation	discrète

Compatibilité des navigateurs

BCD tables only load in the browser