Box-decoration-break - Propriété CSS

Syntaxe de box-decoration-break (schéma).

Description de la propriété box-decoration-break.

box-decoration-break définit comment sont traitées les propriétés de décoration lorsque des éléments sont fragmentés sur plusieurs colonnes ou plusieurs lignes. Lors de l'impression la fragmentation peut être d'une page sur l'autre.

Les propriétés de décoration incluent la bordure, les marges, extérieures et intérieures, le fond et la découpe éventuelle (clip).

Un petit exemple sera plus parlant : ce texte comporte
une bordure rouge
et est fragmenté sur plusieurs lignes.

Valeurs pour box-decoration-break.

• box-decoration-break: slice;

  Valeur par défaut. Les différents fragments sont considérés comme un élément unique. La marge du haut par exemple n'est appliquée qu'au premier fragment ; la marge du bas seulement au dernier fragment. Les bordures englobent les différents fragments comme s'il s'agissait d'un élément unique.

  
• box-decoration-break: clone;

  Chacun des fragments est traité comme un élément à part entière. Les marges sont appliquées à chacun des fragments et les bordures englobent séparément chacun des fragments.

  
• box-decoration-break: initial; (slice) box-decoration-break: inherit; box-decoration-break: revert; box-decoration-break: revertLayer; box-decoration-break: unset;

  Liens vers la présentation de ces différentes valeurs : initial, inherit, revert, revert-layer, unset.

Possibilité d'animation de la propriété box-decoration-break.

La norme du W3C ne prévoit pas que cette propriété puisse être animée. Néanmoins certains navigateur comme Firefox sont capable d'animer box-decoration-break en passant d'une valeur à l'autre sans transition progressive (ce qui est normal puisqu'il ne s'agit pas de valeurs numériques).

La propriété box-decoration-break et Javascript.

Avec Javascript, modifier la valeur de box-decoration-break.

En Javascript, voici comment modifier la valeur de box-decoration-break. On voit que Javascript propose une syntaxe avec la notation kebab-case typique de CSS, et une autre syntaxe en camel-case, plus courante en Javascript.

let el = document.getElementById('id'); el.style['box-decoration-break'] = 'slice'; // ou let el = document.getElementById('id'); el.style.boxDecorationBreak = 'slice';

Avec Javascript, lire la valeur de box-decoration-break.

Ce code fonctionne si la propriété doit avoir été affectée directement à l'élément lui-même avec son attribut style, et non pas en passant par un sélecteur de CSS.

let el = document.getElementById('id'); let value = el.style['box-decoration-break']; // ou let el = document.getElementById('id'); let value = el.style.boxDecorationBreak;

Avec Javascript, lire la valeur calculée de box-decoration-break.

La valeur calculée est celle qui résulte de la cascade des héritages. Si aucune valeur n'est définie ni héritée, la valeur calculée est la valeur initiale de la propriété {soit slice dans le cas de box-decoration-break).

let el = document.getElementById('id'); let value = window.getComputedStyle(el).getPropertyValue('box-decoration-break');

Avec JQuery, modifier la valeur de box-decoration-break.

JQuery permet les mêmes opérations que Javascript avec une syntaxe plus courte.


$('#id').css('box-decoration-break', 'slice');
// ou
$('#id').css('boxDecorationBreak', 'slice');


Avec JQuery, lire la valeur calculée de box-decoration-break.

let value = $('#id').css('box-decoration-break');

Autres exemples de code.

D'autres exemples de code Javascript et JQuery sont donnés sur la page Javascript et CSS.

Testez vous-même.

Les boutons ci-dessous appliquent la valeur saisie à la propriété box-decoration-break et affichent ensuite soit la valeur telle qu'elle a été appliquée, soit la valeur calculée. Dans le cas de box-decoration-break cela ne fait pas de différence car la propriété n'accepte que des valeurs prédéfinies.

Simulateur avec la propriété box-decoration-break.

Ce simulator illustre le fonctionnement de la propriété box-decoration-break dans trois cas de figure différents

Simulateur avec la propriété box-decoration-break.

Cette propriété est maintenant assez bien reconnue par tous les navigateurs. Vous pouvez cependant encore doubler les syntaxes avec le préfixe -webkit- pour améliorer la compatibilité.

Remarques :

(1) Support partiel : ne fonctionne pas à la rupture de colonnes ou de pages.

1

Propriété
box-decoration-break

Estimation de la prise en charge globale.

71%

Navigateurs sur ordinateurs :

Navigateurs sur mobiles :

Navigateurs obsolètes ou marginaux :

Internet Explorer

UC Browser pour Androïd

1

Opéra Mobile

1

QQ Browser

1

Baidu Browser

1

Opéra

1

Firefox pour Androïd

Chrome

Edge

Firefox

Androïd Brower

Chrome pour Androïd

Samsung Internet

1

Safari

1

Safari sur IOS

1

KaiOS Browser

Opéra mini

1

Voir le site Caniuse.com pour plus d'informations de compatibilité.

Caniuse

Évolution de la propriété box-decoration-break.

• Module CSS - Fragmentation - Niveau 3

  Introduction de ce module spécifique aux fragmentation.
  Introduction de la propriété box-decoration-break.
  

  28 Février 2012

  Document de travail.

  

  14 Janvier 2016

  Candidat à la recommandation.

  

  

• Module CSS - Fragmentation - Niveau 4

  Pas de changement concernant la propriété box-decoration-break.
  

  18 Décembre 2018

  Document de travail.

  

  

  

Voir aussi, au sujet des fragmentations.

Le module CSS Fragmentation Module produit par le W3C définit ce qui concerne la fragmentation des éléments, c'est à dire les propriétés suivantes :

Propriétés :