path: root/files/fr/web/css/border-width/index.html

---
title: border-width
slug: Web/CSS/border-width
tags:
  - CSS
  - Propriété
  - Reference
translation_of: Web/CSS/border-width
---
<div>{{CSSRef}}</div>

<p>La propriété CSS <strong><code>border-width</code></strong> est une <a href="/fr/docs/Web/CSS/Propri%C3%A9t%C3%A9s_raccourcies">propriété raccourcie</a> qui définit la largeur de la bordure d'un élément.</p>

<p>Cette propriété raccourcie définit les propriétés détaillées</p>

<ul>
 <li>{{cssxref("border-top-width")}},</li>
 <li>{{cssxref("border-right-width")}},</li>
 <li>{{cssxref("border-bottom-width")}}</li>
 <li>{{cssxref("border-left-width")}}.</li>
</ul>

<p>Si on utilise les propriétés logiques, elle définit {{cssxref("border-block-start-width")}}, {{cssxref("border-block-end-width")}}, {{cssxref("border-inline-start-width")}} et {{cssxref("border-inline-end-width")}}.</p>

<p>Afin de paramétrer une bordure de façon plus pratique, on pourra utiliser la propriété raccourcie {{cssxref("border")}}.</p>

<div>{{EmbedInteractiveExample("pages/css/border-width.html")}}</div>

<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="brush: css no-line-numbers">/* Valeurs avec un mot-clé */
border-width: thin;
border-width: medium;
border-width: thick;

/* Une largeur pour chaque côté */
/* Valeur de type &lt;length&gt; */<em>
</em>border-width: 5px;<em>
</em>
/* largeur verticale puis horizontale */
border-width: 2px 1.5em;

/* haut | largeur horizontale | bas */
border-width: 1px 2em 1.5cm;

/* haut | droite | bas | gauche */
border-width: 1px 2em 0 4rem;

/* Valeurs globales */
border-width: inherit;
border-width: initial;
border-width: unset;
</pre>

<p>La propriété <code>border-width</code> peut être définie avec une, deux, trois ou quatre valeurs.</p>

<ul>
 <li>Lorsqu'une valeur est fournie, elle est appliquée comme largeur pour les quatre côtés</li>
 <li>Lorsque deux valeurs sont fournies, la première est appliquée comme largeur pour la bordure basse et haute et la seconde pour la bordure gauche et droite</li>
 <li>Lorsque trois valeurs sont fournies, la première est appliquée à la bordure haute, la deuxième à la bordure gauche et à la bordure droite et la troisième à la bordure basse</li>
 <li>Lorsque quatres valeurs sont fournies, elles s'appliquent respectivement aux cotés haut, droit, bas et gauche (sens des aiguilles d'une montre).</li>
</ul>

<h3 id="Valeurs">Valeurs</h3>

<dl>
 <dt><code>&lt;line-width&gt;</code></dt>
 <dd>Une valeur de longueur (type {{cssxref("&lt;length&gt;")}} ou un mot-clé indiquant l'épaisseur de la bordure. Le mot-clé doit être l'une des valeurs suivantes :
 <table class="standard-table">
  <tbody>
   <tr>
    <td><code>thin</code></td>
    <td>
     <div style="margin: 0.5em; width: 3em; height: 3em; border-style: solid; border-width: thin; background-color: palegreen;"> </div>
    </td>
    <td>La bordure est fine.</td>
   </tr>
   <tr>
    <td><code>medium</code></td>
    <td>
     <div style="margin: 0.5em; width: 3em; height: 3em; border-style: solid; border-width: medium; background-color: palegreen;"> </div>
    </td>
    <td>La bordure est moyenne.</td>
   </tr>
   <tr>
    <td><code>thick</code></td>
    <td>
     <div style="margin: 0.5em; width: 3em; height: 3em; border-style: solid; border-width: thick; background-color: palegreen;"> </div>
    </td>
    <td>La bordure est épaisse.</td>
   </tr>
  </tbody>
 </table>
  La spécification ne définit pas précisément l'épaisseur correspondante à chacun de ces mots-clés, les rendant dépendants de l'implémentation. Toutefois, la spécification indique que l'épaisseur doit suivre la relation d'inégalité suivante : <code>thin ≤ medium ≤ thick</code> et que les valeurs pour chaque mot-clé doivent être constantes pour un même document.</dd>
</dl>

<h3 id="Syntaxe_formelle">Syntaxe formelle</h3>

{{csssyntax}}

<h2 id="Exemples">Exemples</h2>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;p id="unevaleur"&gt;
  Une valeur : la bordure fait 6px sur les 4 côtés.
&lt;/p&gt;

&lt;p id="deuxvaleurs"&gt;
  Deux valeurs différentes : elle fait 2px en haut
  et en bas et elle mesure 10px pour les bords droit
  et gauche.
&lt;/p&gt;

&lt;p id="troisvaleurs"&gt;
  Trois valeurs différentes : 0.3em pour le haut,
  9px pour le bas et zéro pour la droite et la
  gauche.
&lt;/p&gt;

&lt;p id="quatrevaleurs"&gt;
  Quatre valeurs différentes : "thin" pour le haut,
  "medium" pour la droite, "thick" pour le bas
  et 1em pour la gauche.
&lt;/p&gt;</pre>

<h3 id="CSS">CSS</h3>

<pre class="brush: css">#unevaleur {
  border: ridge #ccc;
  border-width: 6px;
}

#deuxvaleurs {
  border: solid red;
  border-width: 2px 10px;
}

#troisvaleurs {
  border: dotted orange;
  border-width: 0.3em 0 9px;
}

#quatrevaleurs {
  border: solid lightgreen;
  border-width: thin medium thick 1em;
}

p {
  width: auto;
  margin: 0.25em;
  padding: 0.25em;
}</pre>

<h3 id="Résultat">Résultat</h3>

<p>{{EmbedLiveSample('Exemples', 300, 180) }}</p>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaires</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSS3 Backgrounds', '#the-border-width', 'border-width')}}</td>
   <td>{{Spec2('CSS3 Backgrounds')}}</td>
   <td>Pas de modification directe. La modification du type de données {{cssxref("&lt;length&gt;")}} impacte cette propriété.</td>
  </tr>
  <tr>
   <td>{{SpecName('CSS2.1', 'box.html#border-width-properties', 'border-width')}}</td>
   <td>{{Spec2('CSS2.1')}}</td>
   <td>Ajout de la contrainte indiquant que la signification des valeurs doit être constante au sein d'un document.</td>
  </tr>
  <tr>
   <td>{{SpecName('CSS1', '#border-width', 'border-width')}}</td>
   <td>{{Spec2('CSS1')}}</td>
   <td>Définition initiale.</td>
  </tr>
 </tbody>
</table>

<p>{{cssinfo}}</p>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("css.properties.border-width")}}</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>Les propriétés raccourcies liées aux bordures
  <ul>
   <li>{{cssxref("border")}},</li>
   <li>{{cssxref("border-style")}}</li>
   <li>{{cssxref("border-color")}}</li>
  </ul>
 </li>
 <li>Les propriétés liées à la largeur des bordures
  <ul>
   <li>{{cssxref("border-bottom-width")}},</li>
   <li>{{cssxref("border-left-width")}},</li>
   <li>{{cssxref("border-right-width")}},</li>
   <li>{{cssxref("border-top-width")}}</li>
  </ul>
 </li>
</ul>