Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

page-break-before

Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.

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.

Exemple interactif

page-break-before: auto;
page-break-before: always;
<div>
  <p>
    L'effet de cette propriété peut être remarqué lorsque le document est en
    cours d'impression ou qu'un aperçu avant impression est affiché.
  </p>
  <button id="print-btn">Afficher l'aperçu avant impression</button>
  <div class="box-container">
    <div class="box">Contenu avant la propriété</div>
    <div class="box" id="example-element">Contenu avec 'page-break-before'</div>
    <div class="box">Contenu après la propriété</div>
  </div>
</div>
.box {
  border: solid #5b6dcd 5px;
  background-color: #5b6dcd;
  margin: 10px 0;
  padding: 5px;
}

#example-element {
  border: solid 5px #ffc129;
  background-color: #ffc129;
  color: black;
}
const btn = document.getElementById("print-btn");

btn.addEventListener("click", () => {
  window.print();
});

Syntaxe

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: revert;
page-break-before: revert-layer;
page-break-before: unset;

Valeurs

auto Obsolète

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

always Obsolète

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

avoid Obsolète

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

left Obsolète

Le saut de page est forcé avant l'élément afin que la prochaine page soit mise en forme comme une page gauche. C'est la page placée du côté gauche de la reliure du livre ou du côté arrière de la page en impression recto-verso.

Le saut de page est forcé avant l'élément afin que la prochaine page soit mise en forme comme une page droite. C'est la page placée du côté droit de la reliure du livre ou du côté avant de la page en impression recto-verso.

recto Obsolète

Si les pages progressent de gauche à droite, cette valeur agit comme right. Si les pages progressent de droite à gauche, elle agit comme left.

verso Obsolète

Si les pages progressent de gauche à droite, cette valeur agit comme left. Si les pages progressent de droite à gauche, elle agit comme right.

Alias des sauts de page

La propriété page-break-before est désormais une propriété héritée, remplacée par break-before.

Pour des raisons de compatibilité, page-break-before doit être traité par les navigateurs comme un alias de break-before. Cela garantit que les sites utilisant page-break-before continuent de fonctionner comme prévu. Un sous-ensemble de valeurs doit être aliasé comme suit :

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

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 défini
Type d'animationdiscrète

Syntaxe formelle

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

Exemples

Éviter un saut de page avant un élément

css
/* Éviter un saut de page avant les éléments div de classe note */
div.note {
  page-break-before: avoid;
}

Spécifications

Spécification
CSS Logical Properties and Values Module Level 1
# page
CSS Fragmentation Module Level 3
# page-break-properties

Compatibilité des navigateurs

Voir aussi