WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

border-top-width — Dicke des oberen Rahmens

Die Eigenschaft border-top-width legt die Dicke des physischen oberen Rahmens fest. Sie akzeptiert eine nichtnegative Länge oder ein Schlüsselwort; Stil und Farbe des Rahmens werden dadurch nicht festgelegt.

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

Syntax

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 steuert nur die Dicke des oberen Rahmens. Der Anfangswert ist medium; die Eigenschaft wird nicht vererbt. Sie bezieht sich auf die physische Oberkante, die im aktuellen Schreibmodus nicht unbedingt dem Blockanfang entspricht.

Gib eine nichtnegative Länge wie 8px oder thin, medium beziehungsweise thick an. Level 3 überlässt die Dicken dem Browser, verlangt aber, dass thin ≤ medium ≤ thick gilt und die Dicke für jedes Schlüsselwort im gesamten Dokument gleich bleibt. Der Entwurf für Level 4 weist ihnen in dieser Reihenfolge 1px, 3px und 5px zu. Null ist zulässig; negative Werte und Prozentangaben sind ungültig. Level 4 ergänzt hairline, eine dünne Linie, deren Dicke vom Browser bestimmt wird; die Unterstützung muss separat überprüft werden.

Die Breite allein reicht nicht aus: Der Anfangswert von border-top-style ist none. Bei none oder hidden beträgt die verwendete Breite null. Lege beispielsweise solid fest, um einen gewöhnlichen Rahmen anzuzeigen. Eine später angegebene Kurzschreibweise wie border, border-top oder border-width kann diese Breite überschreiben.

Das Beispiel liest die Breite mit solid aus, ändert dann den Stil zu none und liest sie erneut aus. Am Ende ist der Rahmen unsichtbar; der Text zeigt beide Ergebnisse.

Beispiele

<!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>

Ergebnis

solid: 8px
none: 0px

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen