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

CKTIS / CSS

border-left-width — espessura da borda esquerda

A propriedade border-left-width define a espessura da borda do lado físico esquerdo. Aceita um comprimento não negativo ou uma palavra-chave; a visibilidade da borda também depende de border-left-style.

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

Sintaxe

border-left-width: <length [0,∞]> | thin | medium | thick;
/* Level 4 additionally defines hairline; implementation support requires verification. */

border-left-width define a espessura da borda do lado físico esquerdo, não a sua cor nem o seu estilo. É uma propriedade longhand: border-width define as espessuras dos quatro lados, enquanto border-left define a espessura, o estilo e a cor do lado esquerdo.

Os valores básicos são um comprimento não negativo, como 8px, e thin, medium ou thick. As percentagens e os valores negativos são inválidos; 0 é válido. Os atuais rascunhos da especificação atribuem, respetivamente, 1px, 3px e 5px a essas palavras-chave. Level 4 define também hairline, uma linha fina cuja espessura depende do navegador e do dispositivo. Não presuma que é suportado sem o verificar.

O valor inicial é medium e a propriedade não é herdada. No entanto, o valor inicial de border-left-style é none. Quando o estilo é none ou hidden, a espessura usada é 0, mesmo que tenha sido declarado um comprimento positivo. Para apresentar uma borda normal, defina, por exemplo, border-left-style: solid.

O exemplo lê a espessura resolvida através de getComputedStyle() antes e depois de alterar o estilo para none. As linhas esperadas são 8px e 0px; o elemento final não tem uma borda esquerda visível. A execução do exemplo num ambiente isolado com Chromium 157.0.8103.51 confirmou ambas as linhas do resultado.

Exemplos

<!doctype html>
<meta charset="utf-8">
<style>
  #box {
    border-left-style: solid;
    border-left-color: black;
    border-left-width: 8px;
    padding: 8px;
  }
</style>
<div id="box">CSS</div>
<pre id="result"></pre>
<script>
  const box = document.getElementById('box');
  const widths = [getComputedStyle(box).borderLeftWidth];
  box.style.borderLeftStyle = 'none';
  widths.push(getComputedStyle(box).borderLeftWidth);
  document.getElementById('result').textContent = widths.join('\n');
</script>

Resultado

8px
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