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

CKTIS / CSS

border-block-start : configurer le premier bord d’un bloc

Définir ensemble épaisseur, style et couleur du bord choisi par la direction d’écriture des blocs.

Version : CSS Modules

Syntaxe

border-block-start: <line-width> || <line-style> || <color>;

border-block-start est un raccourci pour border-block-start-width, border-block-start-style et border-block-start-color. Il cible le haut en horizontal-tb, la droite en vertical-rl et la gauche en vertical-lr. Il configure un bord, contrairement à border-block qui configure les deux bords de bloc. Épaisseur, style et couleur peuvent apparaître dans tout ordre non ambigu.

Les composantes omises reprennent leurs valeurs initiales : épaisseur medium, style none et couleur currentColor. Ainsi, border-block-start: solid ne conserve ni une épaisseur explicite antérieure ni une couleur rouge. Un raccourci ne contenant qu’une épaisseur ou une couleur rétablit le style none et ne produit généralement pas de bordure visible. Contrairement au raccourci border, ce raccourci de bord logique ne réinitialise pas border-image.

L’exemple utilise une boîte de contenu de 100×40 avec un bord de début dashed rouge de 7px et un bord de fin solid bleu de 2px. Sa hauteur extérieure vaut 49px. Affecter seulement solid produit l’épaisseur medium du navigateur, mesurée ici à 3px, et la couleur rgb(10, 20, 30) de l’élément, soit une hauteur de 45px. Le bord de fin de 2px et le dégradé configuré comme source de border-image restent définis. Le test vérifie la conservation de cette source, pas l’apparence d’une image de bordure découpée.

Rétablir le bord de début de 7px puis passer à vertical-rl le déplace vers la droite. Avec le bord de fin gauche de 2px, la largeur extérieure devient 109px. Cela montre pourquoi block-start n’est pas toujours synonyme de haut. Évitez les déclarations logiques et physiques contradictoires, sauf si leur cascade est intentionnelle ; writing-mode détermine quel bord physique reçoit la valeur gagnante.

Exemples

const box=document.createElement('div');
box.style.cssText='width:100px;height:40px;padding:0;border:0 solid;box-sizing:content-box;color:rgb(10,20,30);border-block-start:7px dashed red;border-block-end:2px solid blue;border-image-source:linear-gradient(red,blue)';
document.body.append(box);
const read=()=>{const s=getComputedStyle(box),r=box.getBoundingClientRect();return [s.borderBlockStartWidth,s.borderBlockStartStyle,s.borderBlockStartColor,r.width,r.height].join('|')};
const initial=read();box.style.borderBlockStart='solid';const reset=read();
const retained=getComputedStyle(box).borderBlockEndWidth+','+(getComputedStyle(box).borderImageSource!=='none');
box.style.borderBlockStart='7px dashed red';box.style.writingMode='vertical-rl';
const vertical=getComputedStyle(box).borderRightWidth+','+box.getBoundingClientRect().width;
console.log('initial='+initial+'; reset='+reset+'; retainedEndAndImage='+retained+'; verticalRight='+vertical);

Résultat

initial=7px|dashed|rgb(255, 0, 0)|100|49; reset=3px|solid|rgb(10, 20, 30)|100|45; retainedEndAndImage=2px,true; verticalRight=7px,109

Exécuté dans Chromium 157.0.8103.51. Les 3px observés pour medium sont un résultat de cette implémentation, pas une définition portable de medium.

Sources