Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

border-top-width — spessore del bordo superiore

La proprietà border-top-width imposta lo spessore del bordo fisico superiore. Accetta una lunghezza non negativa o una parola chiave; non imposta lo stile né il colore del bordo.

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

Sintassi

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 controlla solo lo spessore del bordo superiore. Il valore iniziale è medium e la proprietà non viene ereditata. Si riferisce alla parte superiore fisica, che nella modalità di scrittura corrente non coincide necessariamente con l’inizio del blocco.

Indica una lunghezza non negativa, come 8px, oppure thin, medium o thick. Il livello 3 lascia al browser la scelta degli spessori, ma richiede che si rispetti l’ordine thin ≤ medium ≤ thick e che lo spessore associato a ogni parola chiave rimanga costante in tutto il documento. La bozza del livello 4 assegna loro rispettivamente 1px, 3px e 5px. Zero è valido; i valori negativi e le percentuali non sono validi. Il livello 4 aggiunge hairline, una linea sottile il cui spessore è determinato dal browser; il supporto va verificato separatamente.

La larghezza da sola non basta: il valore iniziale di border-top-style è none. Con none o hidden, la larghezza utilizzata è zero. Imposta, ad esempio, solid per visualizzare un bordo normale. Una successiva abbreviazione come border, border-top o border-width può sovrascrivere questa larghezza.

L’esempio legge la larghezza con solid, poi cambia lo stile in none e la legge di nuovo. Alla fine il bordo è invisibile, mentre il testo mostra entrambi i risultati.

Esempi

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

Risultato

solid: 8px
none: 0px

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti