CSS border-width: como definir a espessura dos quatro lados da borda

No CSS, border-width define a espessura dos quatro lados de uma caixa. Quatro valores seguem a ordem topo, direita, base e esquerda. Se a linha não aparecer após declarar a espessura, verifique se o lado tem um estilo visível como border-style: solid.

Ordem de um a quatro valores

Um valor vale para todos os lados. Dois definem o par vertical e o horizontal. Três definem o topo, o par horizontal e a base.

Valores Topo Direita Base Esquerda
2px 2px 2px 2px 2px
2px 6px 2px 6px 2px 6px
2px 6px 10px 2px 6px 10px 6px
2px 6px 10px 14px 2px 6px 10px 14px

Use comprimentos não negativos, como 2px ou 0.125rem, ou as palavras thin, medium e thick. Porcentagens e valores negativos são inválidos. A especificação atual do W3C define as três palavras como 1px, 3px e 5px.

Especificação do W3C para espessuras de borda

Compare tamanhos com a mesma borda

Salve o código completo como border-width-example.html em UTF-8 e abra-o no navegador. As três caixas têm width: 160px e as mesmas espessuras declaradas. O modelo da caixa e o estilo da borda variam.

<!doctype html>
<html lang="pt">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Compare tamanhos com a mesma borda</title>
  <style>
    body { margin: 1rem; font-family: system-ui, sans-serif; }
    .box {
      width: 160px;
      height: 48px;
      border-style: solid;
      border-color: #2455a3;
      border-width: 2px 6px 10px 14px;
      background: #eef5ff;
    }
    .content { box-sizing: content-box; }
    .border { box-sizing: border-box; }
    .missing { border-style: none; }
  </style>
</head>
<body>
  <p>content-box</p>
  <div class="box content"></div>
  <p>border-box</p>
  <div class="box border"></div>
  <p>border-style: none</p>
  <div class="box content missing"></div>
</body>
</html>

Nas duas primeiras caixas, a borda esquerda de 14px é a mais grossa e a superior de 2px é a mais fina. A primeira mede 180px de largura externa e a segunda 160px. A terceira não mostra borda.

Larguras externas de 180px com content-box, 160px com border-box e 160px na caixa sem borda

Quando a borda não aparece

A terceira caixa declara as mesmas espessuras. Com border-style: none, a espessura computada de cada lado é zero. hidden também resulta em zero. Remova a classe missing para ver a mesma borda da primeira caixa.

Nas ferramentas de desenvolvedor, confira o estilo e a espessura do lado em questão, como border-left-style e border-left-width. Uma declaração abreviada border ou uma regra de um lado específico pode substituir valores anteriores.

Box-sizing e alterações no layout

Com content-box, as bordas laterais são somadas à largura declarada. Sem padding, a primeira caixa mede 160 + 14 + 6 = 180px. Com border-box, a segunda mede 160px por fora e deixa 140px para o conteúdo.

Engrossar a borda ao passar o ponteiro pode alterar a medida externa ou o espaço interno. Para manter o layout estável, reserve a espessura com uma borda transparente e troque apenas a cor, ou use outline. Mantenha visível o foco pelo teclado.

Definição de box-sizing do W3C

Mude a espessura de um lado

Use border-top-width: 6px para mudar só a parte de cima. Os outros lados ficam com as mesmas espessuras. Se ela não aparecer, verifique border-top-style.

Use border-inline-start-width para seguir a direção de leitura. Na escrita horizontal, o lado inicial é o esquerdo para texto da esquerda para a direita e o direito no sentido inverso. Os quatro valores de border-width sempre indicam lados físicos.