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

CKTIS / CSS

border-block-start: configura o primeiro lado de um bloco

Escreve espessura, estilo e cor em conjunto para o lado escolhido pela direção de escrita dos blocos.

Versão: CSS Modules

Sintaxe

border-block-start: <line-width> || <line-style> || <color>;

border-block-start é uma propriedade abreviada de border-block-start-width, border-block-start-style e border-block-start-color. Visa o lado superior em horizontal-tb, o direito em vertical-rl e o esquerdo em vertical-lr. Configura um lado, ao contrário de border-block, que configura ambos os lados de bloco. Espessura, estilo e cor podem aparecer em qualquer ordem inequívoca.

Os componentes omitidos regressam aos valores iniciais: espessura medium, estilo none e cor currentColor. Por isso, border-block-start: solid não mantém uma espessura explícita anterior nem uma cor vermelha. Uma abreviatura que contenha apenas uma espessura ou cor repõe o estilo none e geralmente não produz uma borda visível. Ao contrário da abreviatura border, esta abreviatura de lado lógico não repõe border-image.

O exemplo usa uma caixa de conteúdo de 100×40 com um lado inicial dashed vermelho de 7px e um lado final solid azul de 2px. A altura exterior é 49px. Atribuir apenas solid produz a espessura medium do navegador, aqui medida como 3px, e a cor rgb(10, 20, 30) do elemento, dando uma altura de 45px. Mantêm-se o lado final de 2px e o gradiente configurado como origem de border-image. O teste verifica a conservação dessa origem, não a aparência de uma imagem de borda dividida em segmentos.

Repor o lado inicial de 7px e mudar para vertical-rl desloca-o para a direita. Juntamente com o lado final esquerdo de 2px, a largura exterior passa a 109px. Isto mostra por que motivo block-start não é um sinónimo permanente de topo. Evita declarações lógicas e físicas contraditórias, exceto quando a cascata é intencional; writing-mode determina o lado físico que recebe o valor vencedor.

Exemplos

const box=document.createElement('div');
box.style.cssText='width:100px;height:40px;padding:0;border:0 solid;box-sizing:content-box;color:rgb(10,20,30);border-block-start:7px dashed red;border-block-end:2px solid blue;border-image-source:linear-gradient(red,blue)';
document.body.append(box);
const read=()=>{const s=getComputedStyle(box),r=box.getBoundingClientRect();return [s.borderBlockStartWidth,s.borderBlockStartStyle,s.borderBlockStartColor,r.width,r.height].join('|')};
const initial=read();box.style.borderBlockStart='solid';const reset=read();
const retained=getComputedStyle(box).borderBlockEndWidth+','+(getComputedStyle(box).borderImageSource!=='none');
box.style.borderBlockStart='7px dashed red';box.style.writingMode='vertical-rl';
const vertical=getComputedStyle(box).borderRightWidth+','+box.getBoundingClientRect().width;
console.log('initial='+initial+'; reset='+reset+'; retainedEndAndImage='+retained+'; verticalRight='+vertical);

Resultado

initial=7px|dashed|rgb(255, 0, 0)|100|49; reset=3px|solid|rgb(10, 20, 30)|100|45; retainedEndAndImage=2px,true; verticalRight=7px,109

Executado em Chromium 157.0.8103.51. Os 3px observados para medium são um resultado desta implementação, não uma definição portátil de medium.

Fontes