CKTIS / CSS
border-top-width — épaisseur de la bordure supérieure
La propriété border-top-width définit l’épaisseur de la bordure physique supérieure. Elle accepte une longueur non négative ou un mot-clé ; elle ne définit ni le style ni la couleur de la bordure.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
border-top-width: <length [0,∞]> | thin | medium | thick;
/* Level 4 additionally defines hairline; implementation support requires verification. */
/* CSS-wide keywords may also be used. */border-top-width contrôle uniquement l’épaisseur de la bordure supérieure. Sa valeur initiale est medium et elle n’est pas héritée. Elle vise le haut physique, qui ne correspond pas nécessairement au début du bloc dans le mode d’écriture courant.
Indiquez une longueur non négative, comme 8px, ou thin, medium ou thick. Le niveau 3 laisse le navigateur choisir les épaisseurs, mais exige que l’ordre thin ≤ medium ≤ thick soit respecté et que l’épaisseur associée à chaque mot-clé reste la même dans tout le document. Le projet de spécification du niveau 4 leur attribue respectivement 1px, 3px et 5px. Zéro est valide ; les valeurs négatives et les pourcentages ne le sont pas. Le niveau 4 ajoute hairline, une ligne fine dont l’épaisseur est déterminée par le navigateur ; la prise en charge doit être vérifiée séparément.
La largeur seule ne suffit pas : la valeur initiale de border-top-style est none. Avec none ou hidden, la largeur utilisée est égale à zéro. Définissez par exemple solid pour afficher une bordure ordinaire. Une déclaration ultérieure utilisant le raccourci border, border-top ou border-width peut remplacer cette largeur.
L’exemple lit la largeur avec solid, puis remplace le style par none et la lit de nouveau. À la fin, la bordure est invisible, tandis que le texte affiche les deux résultats.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>border-top-width</title>
<style>
#box {
border-top-style: solid;
border-top-color: black;
border-top-width: 8px;
}
</style>
<div id="box">border-top-width</div>
<pre id="result"></pre>
<script>
const box = document.getElementById('box');
const visibleWidth = getComputedStyle(box).borderTopWidth;
box.style.borderTopStyle = 'none';
const hiddenWidth = getComputedStyle(box).borderTopWidth;
document.getElementById('result').textContent =
`solid: ${visibleWidth}\nnone: ${hiddenWidth}`;
</script>Résultat
solid: 8px none: 0px
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.