Box-decoration-break - Propriété CSS
Résumé des caractéristiques de la propriété box-decoration-break
slice
| clone
slice
box-decoration-break
passe d'une valeur à l'autre sans transition.Syntaxe de box-decoration-break
(schéma).
box-decoration-break
.Cliquez sur le schéma pour plus de détails sur les valeurs
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).
Si votre navigateur accepte d'animer
box-decoration-break
, vous devriez voir l'effet de l'animation
au niveau de la bordure et des angles arrondis.
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
box-decoration-break
sur un élément du type
inline
fragmenté sur plusieurs lignes (par des balises br/).
box-decoration-break
sur un élément du type block
fragmenté sur deux colonnes.
L'effet est visible sur la bordure et sur les arrondis dans les angles.
box-decoration-break
.Cela se voit nettement sur cet exemple : la deuxième colonne affiche soit la suite de l'image (avec la valeur
slice
), soit l'image reprise depuis le début (avec clone
).
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é.
box-decoration-break
.Remarques :
(1) Support partiel : ne fonctionne pas à la rupture de colonnes ou de pages.
box-decoration-break
Navigateurs sur ordinateurs :
Navigateurs sur mobiles :
Navigateurs obsolètes ou marginaux :

Internet Explorer

UC Browser pour Androïd

Opéra Mobile

QQ Browser

Baidu Browser

Opéra

Firefox pour Androïd

Chrome

Edge

Firefox

Androïd Brower

Chrome pour Androïd

Samsung Internet

Safari

Safari sur IOS

KaiOS Browser

Opéra mini
É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 2012Document de travail.14 Janvier 2016Candidat à la recommandation. -
Module CSS - Fragmentation - Niveau 4
Pas de changement concernant la propriétébox-decoration-break
.18 Décembre 2018Document 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 :