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

CKTIS / CSS

border-block-width — épaisseur de bordure sur l’axe de bloc

border-block-width définit l’épaisseur de la bordure au début et à la fin de l’axe de bloc. Une valeur s’applique aux deux côtés ; deux valeurs indiquent respectivement le début et la fin. Leur position physique dépend du mode d’écriture.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

border-block-width: <'border-top-width'>{1,2};

border-block-width est une propriété raccourcie pour border-block-start-width et border-block-end-width. Une valeur définit les deux épaisseurs ; deux valeurs définissent respectivement le début et la fin de l’axe de bloc. Elle ne modifie ni la couleur ni le style de la bordure, ni les épaisseurs de bordure sur l’axe en ligne.

Avec horizontal-tb, il s’agit des côtés supérieur et inférieur ; avec vertical-rl, des côtés droit et gauche. Contrairement à border-width, cette propriété accepte au maximum deux valeurs et décrit des côtés logiques, et non les quatre côtés physiques.

Utilisez des longueurs non négatives comme 2px, ou thin, medium et thick. Les pourcentages et les valeurs négatives sont invalides. Le projet actuel de niveau 4 ajoute aussi hairline ; ne présumez pas de sa prise en charge sans vérification distincte. Les mots-clés globaux CSS comme inherit et initial sont également disponibles.

Les propriétés longues ne sont pas héritées et ont initialement la valeur medium. L’épaisseur seule n’affiche pas une bordure ordinaire : définissez aussi un style, par exemple border-block-style: solid ; avec none ou hidden, l’épaisseur vaut zéro. L’exemple vérifie le mappage des côtés avant et après la modification de writing-mode.

Exemples

const box = document.createElement('div');
box.textContent = 'Block borders';
box.style.cssText = 'writing-mode: horizontal-tb; border-block-style: solid; border-block-width: 2px 6px;';
document.body.append(box);
const horizontal = getComputedStyle(box);
console.log(horizontal.borderTopWidth, horizontal.borderBottomWidth);
box.style.writingMode = 'vertical-rl';
const vertical = getComputedStyle(box);
console.log(vertical.borderRightWidth, vertical.borderLeftWidth);
box.remove();

Résultat

2px 6px
2px 6px

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources