Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła