Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

border-top-width — espessura do contorno superior

A propriedade border-top-width define a espessura do contorno no lado superior físico. Aceita um comprimento não negativo ou uma palavra-chave; não define o estilo nem a cor do contorno.

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

Sintaxe

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 controla apenas a espessura do contorno superior. O valor inicial é medium e a propriedade não é herdada. Refere-se ao topo físico, que não corresponde necessariamente ao início do bloco no modo de escrita atual.

Indique um comprimento não negativo, como 8px, ou uma das palavras-chave thin, medium ou thick. O nível 3 deixa a escolha das espessuras ao navegador, mas exige que a ordem thin ≤ medium ≤ thick seja respeitada e que a espessura de cada palavra-chave se mantenha constante em todo o documento. O projeto de especificação do nível 4 atribui-lhes 1px, 3px e 5px, respetivamente. Zero é válido; valores negativos e percentagens são inválidos. O nível 4 acrescenta hairline, uma linha fina cuja espessura é determinada pelo navegador; o suporte tem de ser verificado separadamente.

A largura, por si só, não é suficiente: o valor inicial de border-top-style é none. Com none ou hidden, a largura utilizada é zero. Defina um estilo como solid para apresentar um contorno normal. Uma propriedade abreviada declarada posteriormente, como border, border-top ou border-width, pode substituir esta largura.

O exemplo lê a largura com solid, altera depois o estilo para none e lê-a novamente. No fim, o contorno não é visível e o texto apresenta ambos os resultados.

Exemplos

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

Resultado

solid: 8px
none: 0px

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes