diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/css/break-before | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/fr/web/css/break-before')
-rw-r--r-- | files/fr/web/css/break-before/index.html | 229 |
1 files changed, 229 insertions, 0 deletions
diff --git a/files/fr/web/css/break-before/index.html b/files/fr/web/css/break-before/index.html new file mode 100644 index 0000000000..35e2f5dbf8 --- /dev/null +++ b/files/fr/web/css/break-before/index.html @@ -0,0 +1,229 @@ +--- +title: break-before +slug: Web/CSS/break-before +tags: + - CSS + - Propriété + - Reference +translation_of: Web/CSS/break-before +--- +<div>{{CSSRef}}</div> + +<p>La propriété<strong> <code>break-before</code></strong> décrit la façon dont la page, la colonne ou la région se fragmente avant la boîte générée. S'il n'y a aucune boîte générée, la propriété est ignorée.</p> + +<pre class="brush:css no-line-numbers">/* Valeurs de rupture génériques */ +break-before: auto; +break-before: avoid; +break-before: always; +break-before: all; + +/* Valeurs de rupture pour les pages */ +break-before: avoid-page; +break-before: page: +break-before: left; +break-before: right; +break-before: recto; +break-before: verso; + +/* Valeurs de rupture pour les colonnes */ +break-before: avoid-column; +break-before: column; + +/* Valeurs de rupture pour les régions */ +break-before: avoid-region; +break-before: region; + +/* Valeurs globales */ +break-before: inherit; +break-before: initial; +break-before: unset; +</pre> + +<p>Chaque point de rupture éventuel (c'est-à-dire chaque frontière d'élément) est influencé par trois propriétés : la valeur de {{cssxref("break-after")}} de l'élément précédent, la valeur de {{cssxref("break-before")}} de l'élément suivant et la valeur de <code>break-inside</code> de l'élément englobant.</p> + +<p>Pour déterminer si on a une rupture, on applique les règles suivantes :</p> + +<ol> + <li>Si l'une des trois valeurs correspond à une rupture forcée (<code>always</code>, <code>left</code>, <code>right</code>, <code>page</code>, <code>column</code> ou <code>region</code>), cette valeur l'emporte. Si plusieurs valeurs décrivent une rupture forcée, c'est celle de l'élément qui apparaît le plus tard dans le flux qui est prise en compte (autrement dit, {{cssxref("break-before")}} l'emporte sur {{cssxref("break-after")}} qui l'emporte sur {{cssxref("break-inside")}}).</li> + <li>Si l'une des trois valeurs correspond à une valeur visant à éviter une rupture (<code>avoid</code>, <code>avoid-page</code>, <code>avoid-region</code>, <code>avoid-column</code>), aucune rupture ne sera appliquée à cet endroit.</li> +</ol> + +<p>Une fois que les ruptures forcées ont été appliquées, le moteur peut ajouter des ruptures « douces » sauf aux endroits où les propriétés empêchent les ruptures.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<p>La propriété <code>break-before</code> se paramètre avec un des mots-clés définis ci-après.</p> + +<h3 id="Valeurs">Valeurs</h3> + +<h4 id="Valeurs_de_rupture_génériques">Valeurs de rupture génériques</h4> + +<dl> + <dt><code>auto</code></dt> + <dd>Valeur initiale qui ne force ni n'interdit de rupture (de page, de colonne ou de région) avant la boîte.</dd> + <dt><code>all</code>{{experimental_inline}}</dt> + <dd>Force la rupture juste avant la boîte principale. La rupture a lieu pour l'ensemble des contextes de fragmentation. Ainsi si l'élément concerné est dans un conteneur multi-colonnes dans un média paginé, il y aura une rupture de colonne et une rupture de page.</dd> + <dt><code>always</code>{{experimental_inline}}</dt> + <dd>Force la rupture juste avant la boîte principale. Le type de rupture dépend du contexte de fragmentation englobant l'élément. Si l'élément est situé dans un conteneur multi-colonne, une rupture de colonne sera ajoutée. Si l'élément est situé dans un média paginé (mais pas dans un conteneur multi-colonnes), la rupture introduite sera une rupture de page.</dd> + <dt><code>avoid</code></dt> + <dd>Empêche toute rupture (de page, de colonne ou de région) avant la boîte.</dd> +</dl> + +<h4 id="Valeurs_de_rupture_liées_aux_médias_paginés">Valeurs de rupture liées aux médias paginés</h4> + +<dl> + <dt><code>avoid-page</code></dt> + <dd>Empêche toute saut de page avant la boîte de l'élément.</dd> + <dt><code>page</code></dt> + <dd>Force un saut de page avant la boîte de l'élément</dd> + <dt><code>left</code></dt> + <dd>Force un ou deux saut de page avant la boîte de l'élément afin que la prochaine page soit une page gauche.</dd> + <dt><code>recto</code> {{experimental_inline}}</dt> + <dd>Force un ou deux sauts de page avant la boîte de l'élément afin que la prochaine page soit une page recto (une page droite pour le sens de lecture gauche à droite et une page gauche pour le sens de lecture droite à gauche).</dd> + <dt><code>right</code></dt> + <dd>Force un ou deux saut de page avant la boîte de l'élément afin que la prochaine page soit une page droite.</dd> + <dt><code>verso</code>{{experimental_inline}}</dt> + <dd>Force un ou deux sauts de page avant la boîte de l'élément afin que la prochaine page soit une page verso (une page gauche pour le sens de lecture gauche à droite et une page droite pour le sens de lecture droite à gauche).</dd> +</dl> + +<h4 id="Valeurs_de_ruptures_relatives_aux_dispositions_en_colonnes">Valeurs de ruptures relatives aux dispositions en colonnes</h4> + +<dl> + <dt><code>avoid-column</code></dt> + <dd>Empêche toute rupture de colonne avant la boîte de l'élément.</dd> + <dt><code>column</code></dt> + <dd>Force une rupture de colonne de page avant la boîte de l'élément.</dd> +</dl> + +<h4 id="Valeurs_de_ruptures_relatives_aux_régions">Valeurs de ruptures relatives aux régions</h4> + +<dl> + <dt><code>region</code>{{experimental_inline}}</dt> + <dd>Force une rupture de région avant la boîte de l'élément.</dd> + <dt><code>avoid-region</code>{{experimental_inline}}</dt> + <dd>Empêche toute rupture de région avant la boîte de l'élément.</dd> +</dl> + +<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> + +<pre class="syntaxbox">{{csssyntax}}</pre> + +<h2 id="Aliassynonymes_pour_les_ruptures_de_page">Alias/synonymes pour les ruptures de page</h2> + +<p>Pour des raisons de compatibilité, la propriété historique {{cssxref("page-break-before")}} devrait être considérée par les navigateurs comme un synonyme de <code>break-before</code>. Cela permet aux sites utilisant <code>page-break-before</code> de continuer à fonctionner comme précédemment. Voici un sous-ensemble des valeurs avec leurs alias :</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col"><code>page-break-before</code></th> + <th scope="col"><code>break-before</code></th> + </tr> + </thead> + <tbody> + <tr> + <td><code>auto</code></td> + <td><code>auto</code></td> + </tr> + <tr> + <td><code>left</code></td> + <td><code>left</code></td> + </tr> + <tr> + <td><code>right</code></td> + <td><code>right</code></td> + </tr> + <tr> + <td><code>avoid</code></td> + <td><code>avoid</code></td> + </tr> + <tr> + <td><code>always</code></td> + <td><code>page</code></td> + </tr> + </tbody> +</table> + +<div class="blockIndicator note"> +<p><strong>Note :</strong> La valeur <code>always</code> pour <code>page-break-before</code> a été implémentée par les navigateurs comme une rupture de page et non comme une rupture de colonne. C'est pourquoi l'alias ici utilisé est <code>page</code> et non <code>always</code>.</p> +</div> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="CSS">CSS</h3> + +<pre class="brush: css">.exemple { + -webkit-column-count: 4; + -moz-column-count: 4; + column-count: 4; +} + +p { + break-before: avoid-column; + /* Pour Firefox : */ + page-break-before: avoid; + /* Pour WebKit : */ + -webkit-column-break-before: avoid; +} +</pre> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html"><div class="exemple"> + <p>« Mais alors, » pensa Alice, « ne serai-je donc + jamais plus vieille que je ne le suis maintenant ? + D’un côté cela aura ses avantages, ne jamais être + une vieille femme. Mais alors avoir toujours des + leçons à apprendre ! Oh, je n’aimerais pas cela du + tout. »</p> + <p>« Oh ! Alice, petite folle, » se répondit-elle. + « Comment pourriez-vous apprendre des leçons ici ? + Il y a à peine de la place pour vous, et il n’y en + a pas du tout pour vos livres de leçons. »</p> +</div></pre> + +<h3 id="Résultat">Résultat</h3> + +<p>{{EmbedLiveSample("Exemples","400","300")}}</p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('CSS3 Fragmentation', '#break-between', 'break-before')}}</td> + <td>{{Spec2('CSS3 Fragmentation')}}</td> + <td>Ajouts des mots-clés <code>recto</code> et <code>verso</code>. Le type de média pour cette propriété est passé de <code>paged</code> à <code>visual</code>. L'algorithme de rupture est précisé afin de gérer les différents types de rupture.</td> + </tr> + <tr> + <td>{{SpecName('CSS3 Regions', '#region-flow-break', 'break-before')}}</td> + <td>{{Spec2('CSS3 Regions')}}</td> + <td>La spécification étend la propriété pour gérer les sauts de région. Les mots-clés <code>avoid-region</code> et <code>region</code> sont ajoutés.</td> + </tr> + <tr> + <td>{{SpecName('CSS3 Multicol', '#break-before-break-after-break-inside', 'break-before')}}</td> + <td>{{Spec2('CSS3 Multicol')}}</td> + <td>Définition initiale. La spécification étend la propriété {{cssxref("page-break-before")}} de CSS 2.1 afin de gérer les sauts de page ou de colonne.</td> + </tr> + </tbody> +</table> + +<p>{{cssinfo}}</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> + +<h3 id="Prise_en_charge_pour_une_disposition_multi-colonnes">Prise en charge pour une disposition multi-colonnes</h3> + +<p>{{Compat("css.properties.break-before.multicol_context")}}</p> + +<h3 id="Prise_en_charge_pour_les_média_paginés">Prise en charge pour les média paginés</h3> + +<p>{{Compat("css.properties.break-before.paged_context")}}</p> |