page-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.

Note : Cette propriété est en train d'être remplacée progressivement par la propriété break-before plus générique. Cette nouvelle propriété gère aussi les colonnes et les régions et elle est syntaxiquement compatible avec page-break-before.

Avant d'utiliser page-break-before, vérifiez si vous pouvez utiliser break-before. À l'avenir page-break-before ne sera plus qu'un simple alias pour certaines valeurs de break-beforeb.

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
Média	visuel, paged
Valeur calculée	comme spécifié
Animable	non
Ordre canonique	l'ordre unique et non-ambigu défini par la grammaire formelle

Syntaxe

/* 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;

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 à leftt. Si la page progresse de droite à gauche, elle est synonyme de right.

Syntaxe formelle

auto | always | avoid | left | right

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	Statut	Commentaires
CSS Logical Properties 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.

Fonctionnalité	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Support simple (`auto`, `always`)	1.0	1.0 (1.7 ou moins)	4.0	7.0	1.2 (125)
`avoid`, `left`, `right`	1.0	Pas de support (bug 132035)	4.0	7.0	1.2 (125)

Fonctionnalité	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Support simple	?	1.0 (1.0)	?	?	?
`avoid`, `left`, `right`	?	Pas de support (bug 132035)	?	?	?