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

CKTIS / CSS

border-left — borda esquerda

border-left é uma propriedade abreviada que define a largura, o estilo e a cor da borda física esquerda. Os componentes omitidos voltam aos valores iniciais, pelo que a ausência do estilo pode tornar a borda invisível.

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

Sintaxe

Level 3: border-left: <line-width> || <line-style> || <color>;
Level 4 (draft): border-left: <line-width> || <line-style> || [ <color> | <image-1D> ];

border-left define em conjunto border-left-width, border-left-style e border-left-color. Aplica-se à borda física esquerda, não ao início de uma linha determinado pela direção da escrita. Não é uma propriedade herdada.

A sintaxe do nível 3 é border-left: <line-width> || <line-style> || <color>;. O projeto do nível 4 admite também uma imagem unidimensional (<image-1D>) em vez de uma cor: border-left: <line-width> || <line-style> || [ <color> | <image-1D> ];. Em ambas as formas, || significa que é necessário indicar pelo menos um componente e que os componentes podem surgir em qualquer ordem. No nível 3, a largura pode ser um comprimento não negativo ou uma das palavras-chave thin, medium ou thick. No projeto do nível 4, <line-width> também aceita hairline. Não são permitidas percentagens em nenhum dos dois níveis. solid, dashed e none são exemplos de estilos.

Os componentes omitidos recebem os valores iniciais: medium, none e currentcolor. Assim, border-left: 6px; repõe o estilo em none, mesmo que anteriormente fosse solid; a largura utilizada passa então a ser zero. Para alterar apenas a largura sem repor o estilo e a cor, use border-left-width.

O exemplo deverá apresentar Note com uma borda esquerda azul contínua, com 6 píxeis CSS de largura, e um espaçamento interno de 12 píxeis CSS em cada lado. Este é o resultado esperado, não uma confirmação de que foi realizado um teste.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>border-left</title>
<style>
  .note {
    border-left: 6px solid #0055aa;
    padding: 12px;
  }
</style>
<div class="note">Note</div>
</html>

Resultado

A box containing “Note”, with a solid blue left border 6 CSS pixels wide and 12 CSS pixels of padding on every side.

O exemplo usa a sintaxe do nível 3: `6px` define a largura da borda esquerda, `solid` define o estilo e `#0055aa` define a cor.

Fontes