Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

border-block-color : distinguer les couleurs de début et de fin

Définir une couleur pour les deux bordures de bloc ou une paire début/fin, tout en conservant leurs épaisseurs et styles de trait.

Version : CSS Modules

Syntaxe

border-block-color: red blue;

border-block-color ne contrôle que les deux couleurs de l’axe de bloc. Une couleur s’applique aux deux extrémités ; avec deux valeurs, la première correspond à block-start et la seconde à block-end. Cet ordre est logique, pas toujours haut puis bas. En vertical-rl, red blue signifie une bordure droite rouge et une bordure gauche bleue. En horizontal-tb, la même paire signifie rouge en haut et bleu en bas. Passer uniquement direction à rtl dans ces modes n’inverse pas cette paire de l’axe de bloc.

Ce raccourci de couleur ne fait pas apparaître une bordure absente. Son épaisseur et son style sont distincts ; un côté de style none n’a pas de trait visible, même si sa couleur calculée est rouge. À l’inverse, changer ces couleurs conserve les épaisseurs solid existantes. transparent conserve la place d’une bordure qui serait autrement visible ; cela ne revient pas à supprimer son style. Avec currentColor, le côté choisi suit la valeur color de l’élément. Utilisez les propriétés de couleur individuelles de début et de fin si une déclaration ultérieure ne doit changer qu’une extrémité.

Le test commence avec une boîte de contenu de 80×40, quatre bordures solid de 4px et vertical-rl. Il lit rouge à droite et bleu à gauche, puis obtient la même paire après le passage de direction à rtl. Une seule couleur verte rend les deux côtés verts sans modifier leurs épaisseurs de 4px ni la boîte de bordure de 88×48. Une boîte séparée qui ne reçoit que border-block-color: red blue reste à 80×40 : son style de fin est none et son épaisseur résolue vaut 0px.

Exemples

const el=document.createElement('div');el.style.cssText='writing-mode:vertical-rl;direction:ltr;width:80px;height:40px;box-sizing:content-box;padding:0;border:4px solid black;border-block-color:rgb(255,0,0) rgb(0,0,255)';document.body.append(el);
const read=label=>{const s=getComputedStyle(el),r=el.getBoundingClientRect();console.log(label+'='+[s.borderRightColor,s.borderLeftColor].join('|')+'; widths='+s.borderRightWidth+','+s.borderLeftWidth+'; box='+r.width+'x'+r.height)};
read('pair');el.style.direction='rtl';read('rtl');el.style.borderBlockColor='rgb(0,128,0)';read('single');
const bare=document.createElement('div');bare.style.cssText='width:80px;height:40px;border-block-color:red blue';document.body.append(bare);const s=getComputedStyle(bare),r=bare.getBoundingClientRect();console.log('color-only='+s.borderBlockEndStyle+','+s.borderBlockEndWidth+'; box='+r.width+'x'+r.height);

Résultat

pair=rgb(255, 0, 0)|rgb(0, 0, 255); widths=4px,4px; box=88x48
rtl=rgb(255, 0, 0)|rgb(0, 0, 255); widths=4px,4px; box=88x48
single=rgb(0, 128, 0)|rgb(0, 128, 0); widths=4px,4px; box=88x48
color-only=none,0px; box=80x40

Les cas utilisant des valeurs de couleur ont été exécutés dans Chromium 157.0.8103.51. CSS Borders Level 4 définit aussi des extensions plus récentes des valeurs de couleur des bordures ; cet exemple ne prouve pas leur prise en charge, ni celle des images de bordure ou du rendu forced-colors.

Sources