CSS border-width : régler l’épaisseur de chaque côté d’une bordure

En CSS, border-width règle l’épaisseur sur les quatre côtés d’une boîte. Quatre valeurs s’appliquent dans l’ordre haut, droite, bas, gauche. Si le trait n’apparaît pas malgré une épaisseur définie, vérifiez que le côté a un style visible comme border-style: solid.

Ordre des valeurs pour les quatre côtés

Une valeur s’applique partout. Deux valeurs définissent les côtés verticaux puis horizontaux, dans le sens des directions haut-bas et gauche-droite. Trois valeurs règlent le haut, la paire gauche-droite puis le bas.

Valeurs Haut Droite Bas Gauche
2px 2px 2px 2px 2px
2px 6px 2px 6px 2px 6px
2px 6px 10px 2px 6px 10px 6px
2px 6px 10px 14px 2px 6px 10px 14px

Utilisez une longueur positive ou nulle, comme 2px ou 0.125rem, ou les mots-clés thin, medium et thick. Les pourcentages et les valeurs négatives sont invalides. La spécification W3C actuelle définit ces mots-clés par 1px, 3px et 5px.

Spécification W3C sur l’épaisseur des bordures

Comparer la taille avec la même bordure

Enregistrez le code complet en UTF-8 dans border-width-example.html, puis ouvrez-le dans le navigateur. Chaque boîte déclare width: 160px et les mêmes épaisseurs. Le modèle de boîte et le style de bordure changent.

<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Comparer la taille avec la même bordure</title>
  <style>
    body { margin: 1rem; font-family: system-ui, sans-serif; }
    .box {
      width: 160px;
      height: 48px;
      border-style: solid;
      border-color: #2455a3;
      border-width: 2px 6px 10px 14px;
      background: #eef5ff;
    }
    .content { box-sizing: content-box; }
    .border { box-sizing: border-box; }
    .missing { border-style: none; }
  </style>
</head>
<body>
  <p>content-box</p>
  <div class="box content"></div>
  <p>border-box</p>
  <div class="box border"></div>
  <p>border-style: none</p>
  <div class="box content missing"></div>
</body>
</html>

Les deux premières boîtes ont la bordure la plus épaisse à gauche, à 14px, et la plus fine en haut, à 2px. La première mesure 180px de large au total et la deuxième 160px. La troisième n’a pas de bordure visible.

Largeurs extérieures comparées : 180px avec content-box, 160px avec border-box et 160px pour la boîte sans bordure

Quand la bordure n’apparaît pas

La troisième boîte déclare les mêmes épaisseurs. Avec border-style: none, l’épaisseur calculée vaut zéro pour chaque côté. hidden donne aussi zéro. Retirez la classe missing pour afficher la même bordure que la première boîte.

Dans les outils de développement, examinez le style et l’épaisseur du côté concerné, par exemple border-left-style et border-left-width. Un raccourci border ou une déclaration sur un côté particulier peut remplacer un réglage précédent.

Box-sizing et variations de taille

Avec content-box, les bordures latérales s’ajoutent à la largeur déclarée. Ici, sans marge intérieure, la première boîte mesure 160 + 14 + 6 = 180px. Avec border-box, la deuxième reste à 160px au total et dispose de 140px pour le contenu.

Épaissir une bordure au survol peut modifier la largeur de la boîte ou l’espace intérieur. Pour garder la disposition stable, réservez l’épaisseur avec une bordure transparente et changez sa couleur, ou utilisez outline. Gardez le focus clavier visible.

Définition W3C de box-sizing

Modifier un seul côté

Utilisez border-top-width: 6px pour épaissir uniquement le côté supérieur. Les autres côtés gardent leur valeur. Si le trait n’apparaît pas, vérifiez border-top-style.

Utilisez border-inline-start-width pour suivre le sens de lecture. En écriture horizontale, le début est à gauche pour un texte de gauche à droite et à droite pour un texte de droite à gauche. Les quatre valeurs de border-width désignent toujours les côtés physiques.