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

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.

Fontes