diff options
Diffstat (limited to 'files/fr/web/css/border-width')
| -rw-r--r-- | files/fr/web/css/border-width/index.html | 216 |
1 files changed, 216 insertions, 0 deletions
diff --git a/files/fr/web/css/border-width/index.html b/files/fr/web/css/border-width/index.html new file mode 100644 index 0000000000..a4ced190b5 --- /dev/null +++ b/files/fr/web/css/border-width/index.html @@ -0,0 +1,216 @@ +--- +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 <length> */<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><line-width></code></dt> + <dd>Une valeur de longueur (type {{cssxref("<length>")}} 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> + +<pre class="syntaxbox">{{csssyntax}}</pre> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html"><p id="unevaleur"> + Une valeur : la bordure fait 6px sur les 4 côtés. +</p> + +<p id="deuxvaleurs"> + Deux valeurs différentes : elle fait 2px en haut + et en bas et elle mesure 10px pour les bords droit + et gauche. +</p> + +<p id="troisvaleurs"> + Trois valeurs différentes : 0.3em pour le haut, + 9px pour le bas et zéro pour la droite et la + gauche. +</p> + +<p id="quatrevaleurs"> + Quatre valeurs différentes : "thin" pour le haut, + "medium" pour la droite, "thick" pour le bas + et 1em pour la gauche. +</p></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("<length>")}} 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> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une<em>pull request</em>.</div> + +<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> |