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

CKTIS / CSS

border-image-source — origem da imagem da borda

A propriedade border-image-source seleciona uma imagem que substitui a borda CSS normal. Aceita none ou <image>, incluindo gradientes. Define a origem; as outras propriedades border-image-* controlam o recorte e o posicionamento.

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

Sintaxe

border-image-source: none | <image>;

border-image-source aceita none ou <image>, por exemplo url("frame.png") ou linear-gradient(...). O valor inicial é none; a propriedade não é herdada e o seu tipo de animação é discreto. Se estiver disponível, uma imagem substitui a borda normal. Com none, ou se não for possível apresentar a imagem, é usada a borda normal.

A origem não define o recorte: essa função cabe a border-image-slice. border-image-width, border-image-outset e border-image-repeat controlam a largura, a extensão e a repetição dos fragmentos. O centro da imagem é descartado por predefinição; a palavra-chave fill em border-image-slice mantém-no.

As bordas com imagem não alteram a disposição: o espaço reservado continua a depender de border-width e border-style. Define border antes das propriedades border-image-*, porque essa propriedade abreviada as repõe. A propriedade não se aplica aos elementos internos de tabelas quando border-collapse: collapse.

O exemplo utiliza um gradiente sem ficheiros externos. O resultado esperado é uma área de conteúdo branca de 160 × 80 px com uma borda de 12 px, azul à esquerda e vermelha à direita. Se alterares border-image-source para none, deverá surgir uma borda preta sem alteração das dimensões.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>border-image-source</title>
<style>
  .frame {
    width: 160px;
    height: 80px;
    border: 12px solid black;
    border-image-source: linear-gradient(to right, #0000ff, #ff0000);
    border-image-slice: 1;
    background: white;
  }
</style>
<div class="frame"></div>
</html>

Resultado

A white 160 × 80 px content area surrounded by a 12 px gradient border, blue on the left and red on 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