CKTIS / CSS
border-image-width — espessura do contorno com imagem
border-image-width controla a espessura das faixas da imagem do contorno, não o espaço reservado aos contornos na disposição. Aceita comprimentos, percentagens, multiplicadores de border-width ou auto.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
border-image-width: [ <length-percentage [0,∞]> | <number [0,∞]> | auto ]{1,4};border-image-width define as distâncias para dentro a partir das extremidades da área da imagem do contorno, que, por predefinição, corresponde à border box. Não altera a disposição; o espaço reservado ao contorno depende de border-width e border-style. border-image-slice recorta a imagem de origem, enquanto esta propriedade define a espessura das faixas resultantes.
O valor inicial é 1; a propriedade não é herdada. Um número sem unidade multiplica o border-width calculado do lado correspondente. Um comprimento define diretamente a espessura. As percentagens usam a altura da área para cima/baixo e a largura para esquerda/direita. auto usa a dimensão natural do recorte correspondente ou, se esta não estiver disponível, o border-width calculado.
Podem ser indicados 1 a 4 valores: um para todos os lados; dois para cima/baixo e esquerda/direita; três para cima, esquerda/direita e baixo; quatro pela ordem cima, direita, baixo, esquerda. Os valores negativos são inválidos. Se faixas opostas se sobrepuserem, todas as espessuras são reduzidas proporcionalmente.
No exemplo, 2 1 produz faixas de 20px em cima e em baixo e de 10px nos lados, mas a border box mantém-se em 220px × 100px. As faixas mais espessas são pintadas para dentro sem reservar espaço adicional.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>border-image-width</title>
<style>
.frame {
box-sizing: content-box;
width: 200px;
height: 80px;
padding: 0;
border: 10px solid black;
border-image-source: linear-gradient(#0066cc, #0066cc);
border-image-slice: 1;
border-image-width: 2 1;
border-image-repeat: stretch;
}
</style>
<div class="frame"></div>Resultado
Expected: a blue frame with 20px top and bottom image bands and 10px left and right image bands. The border box remains 220px × 100px.
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.