Aller au contenu

Propriété CSS box-decoration-break

La propriété box-decoration-break est une propriété CSS qui spécifie comment l'arrière-plan, la marge intérieure, la bordure, l'image de bordure, l'ombre de boîte, la marge et le chemin de découpe d'un élément sont appliqués lorsque la boîte est fragmentée.

La propriété box-decoration-break possède deux valeurs. La valeur slice applique les décorations à l'élément entier comme s'il n'était pas fragmenté, puis découpe la boîte au niveau des bords de chaque fragment. La valeur clone applique chaque décoration à chaque fragment indépendamment. Les bordures entourent les quatre bords de chaque fragment, et les arrière-plans sont entièrement redessinés pour chaque fragment. Notez que la fragmentation peut se produire non seulement en raison de sauts de ligne, mais aussi de sauts de page ou de colonnes.

Valeur initialeslice
S'applique àÉléments de niveau bloc, conteneurs flex et conteneurs grille.
HéritéeNon.
VersionCSS3
Syntaxe DOMobject.style.boxDecorationBreak = "clone";

Syntaxe

Syntaxe de la propriété CSS box-decoration-break

css
box-decoration-break: slice | clone | initial | inherit | unset;

Voici un exemple avec la valeur clone, où les décorations s'appliquent à chaque fragment comme si les fragments étaient des éléments individuels.

Exemple de la propriété CSS box-decoration-break avec la valeur clone

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      span {
        border: 3px solid #1c87c9;
        padding: 0em 1em;
        border-radius: 12px;
        font-size: 20px;
        line-height: 2;
      }
      span.box {
        box-decoration-break: clone;
        -webkit-box-decoration-break: clone;
      }
    </style>
  </head>
  <body>
    <h2>Box-decoration-break example</h2>
    <p>Here the box-decoration-break is set to "clone".</p>
    <span class="box">Box<br />decoration<br />break<br />property<br />example.</span>
  </body>
</html>

Résultat

CSS box-decoration-break Property

Les navigateurs modernes prennent en charge cette propriété nativement sans préfixes, mais le préfixe -webkit- est inclus dans les exemples pour assurer la compatibilité avec les anciennes versions.

Voyons un autre exemple où la valeur slice est appliquée à la boîte. Ici, la boîte est découpée en morceaux.

Exemple de la propriété CSS box-decoration-break avec la valeur slice

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      span {
        border: 3px solid #8ebf42;
        padding: 0em 1em;
        border-radius: 12px;
        font-size: 20px;
        line-height: 2;
        background-color: #ccc;
      }
      span.box {
        -webkit-box-decoration-break: slice;
        box-decoration-break: slice;
      }
    </style>
  </head>
  <body>
    <h2>Box-decoration-break example</h2>
    <p>
      Here the box-decoration-break is set to "slice" which is the default value of this property.
    </p>
    <span class="box">Box<br />decoration<br />break<br />property<br />example.</span>
  </body>
</html>

Résultat

CSS box-decoration-break Property with slice value

Voyons maintenant comment une ombre de boîte est appliquée à la boîte découpée.

Exemple de la propriété CSS box-decoration-break avec la valeur slice et une ombre

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      span {
        border: 3px solid #8ebf42;
        padding: 0em 1em;
        border-radius: 12px;
        font-size: 20px;
        line-height: 2;
        background-color: #cccccc;
        box-shadow: 5px 4px 10px #666666;
        box-decoration-break: slice;
        -webkit-box-decoration-break: slice;
      }
    </style>
  </head>
  <body>
    <h2>Box-decoration-break example</h2>
    <p>
      Here the box-decoration-break is set to "slice" which is the default value of this property.
    </p>
    <span>Box<br />decoration<br />break<br />property<br />example.</span>
  </body>
</html>

Résultat

CSS box-decoration-break Property with slice value and shadow

Valeurs

ValeurDescription
sliceLes décorations de la boîte sont appliquées à l'élément entier et se coupent aux bords des fragments de l'élément.
cloneLes décorations de la boîte sont appliquées à chaque fragment individuellement.
initialDéfinit la propriété sur sa valeur par défaut.
inheritHérite la propriété de son élément parent.

Pratique

Que fait la propriété CSS box-decoration-break ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.