CKTIS / CSS
border-top-width — grubość górnego obramowania
Właściwość border-top-width ustala grubość fizycznej górnej krawędzi obramowania. Przyjmuje nieujemną długość lub słowo kluczowe; sama nie ustawia stylu ani koloru obramowania.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
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 steruje tylko grubością górnego obramowania. Wartość początkowa to medium; właściwość nie jest dziedziczona. Dotyczy fizycznej góry, niekoniecznie początku bloku w danym trybie pisania.
Możesz podać nieujemną długość, np. 8px, albo thin, medium, thick. Level 3 pozostawia dobór grubości przeglądarce, ale wymaga zachowania relacji thin ≤ medium ≤ thick oraz stałej grubości dla każdego słowa kluczowego w obrębie dokumentu. Projekt specyfikacji Level 4 przypisuje im odpowiednio 1px, 3px i 5px. Zero jest poprawne; wartości ujemne i procenty są niedozwolone. Level 4 dodaje hairline, czyli cienką linię o grubości określanej przez przeglądarkę; obsługę trzeba zweryfikować osobno.
Sama szerokość nie wystarczy: początkowy border-top-style to none. Przy none lub hidden używana szerokość wynosi zero. Ustaw np. solid, aby zobaczyć zwykłe obramowanie. Późniejszy skrót border, border-top lub border-width może nadpisać tę szerokość.
Przykład odczytuje szerokość dla solid, następnie zmienia styl na none i odczytuje ją ponownie. Końcowo obramowanie jest niewidoczne, a tekst pokazuje oba wyniki.
Przykłady
<!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>Wynik
solid: 8px none: 0px
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.