CKTIS / CSS
border-image — uma borda baseada numa imagem
border-image é uma propriedade abreviada de CSS que cria uma borda a partir de uma imagem ou de um gradiente. Define a origem, o recorte, a largura, a extensão e a repetição, mas não reserva espaço adicional no esquema da página.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
border-image: <'border-image-source'> || <'border-image-slice'> [ / <'border-image-width'> | / <'border-image-width'>? / <'border-image-outset'> ]? || <'border-image-repeat'>;border-image define cinco propriedades: border-image-source, border-image-slice, border-image-width, border-image-outset e border-image-repeat. Os componentes omitidos voltam, respetivamente, a none, 100%, 1, 0 e stretch. A propriedade não é herdada.
A imagem é dividida em nove partes: cantos, bordas e centro. border-image-slice define os cortes com números sem unidade ou percentagens; o centro é descartado, a menos que especifiques fill. Não confundas o recorte da imagem com a largura da borda pintada: um número em border-image-width multiplica o valor correspondente de border-width.
As barras separam a largura e a extensão do recorte: 1 / 1 / 0. A notação 1 / / 4px omite a largura. Os modos das bordas são stretch, repeat, round e space; dois valores aplicam-se, respetivamente, aos eixos horizontal e vertical.
A imagem não altera o esquema da página: o espaço continua a depender de border-width e border-style. Define uma borda normal como alternativa caso a imagem não possa ser apresentada. Coloca border antes de border-image, porque uma declaração border posterior repõe esta propriedade abreviada. O exemplo usa um gradiente sem ficheiros externos.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>border-image</title>
<style>
.frame {
width: 160px;
height: 80px;
border: 12px solid gray;
border-image: linear-gradient(to right, #0066cc, #cc3300) 1 / 1 / 0 stretch;
background: white;
}
</style>
<div class="frame"></div>
Resultado
A 184px × 104px rectangular box with a white 160px × 80px interior and a 12px gradient border, blue at the left and red-orange at the right.
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.