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

CKTIS / CSS

border-image-repeat — repetição de uma imagem de contorno

A propriedade border-image-repeat controla o alongamento e a repetição em mosaico das partes de uma imagem de contorno. Aceita uma ou duas palavras-chave que controlam, de forma independente, as direções horizontal e vertical.

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

Sintaxe

border-image-repeat: [ stretch | repeat | round | space ]{1,2};

border-image-repeat controla o redimensionamento e a repetição em mosaico das partes de uma imagem de contorno. O primeiro valor controla a direção horizontal das partes superior, central e inferior; o segundo controla a direção vertical das partes esquerda, central e direita. Se o segundo valor for omitido, é igual ao primeiro. A ordem não é cima–direita–baixo–esquerda.

stretch alonga uma parte para preencher a respetiva área. repeat repete-a em mosaico, podendo as cópias nas extremidades ser cortadas. round também ajusta o tamanho dos mosaicos para caber um número inteiro. space mantém o tamanho dos mosaicos após o redimensionamento inicial e distribui o espaço restante à sua volta.

O valor inicial é stretch; a propriedade não é herdada e a animação é discreta. Não fornece uma imagem por si só: define também border-image-source e valores adequados para border-image-slice. O centro só é pintado se fill estiver incluído em border-image-slice. Uma declaração posterior da forma abreviada border-image pode repor a definição de repetição.

O exemplo utiliza round stretch: os contornos superior e inferior são repetidos em mosaico com ajuste de tamanho, enquanto os contornos laterais são alongados. A caixa de conteúdo mede 230px × 90px e tem um contorno de 12px; a imagem de contorno não pinta o centro.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>border-image-repeat</title>
<style>
  .frame {
    width: 230px;
    height: 90px;
    border: 12px solid #334155;
    border-image-source: repeating-linear-gradient(
      90deg, #2563eb 0 10px, #fbbf24 10px 20px
    );
    border-image-slice: 12;
    border-image-repeat: round stretch;
  }
</style>
<div class="frame"></div>

Resultado

A 230px × 90px content box with a 12px image border. The top and bottom edge slices use round; the left and right edge slices use stretch. The center remains unpainted by the border image.

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