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.