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

CKTIS / CSS

mask-repeat — repetir uma imagem de máscara

A propriedade mask-repeat controla se e como uma imagem de máscara se repete na horizontal e na vertical. Permite apresentar uma única máscara, criar mosaicos regulares ou ajustar o espaçamento ou o tamanho dos mosaicos.

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

Sintaxe

mask-repeat: <repeat-style>#;
<repeat-style> = repeat-x | repeat-y | [ repeat | space | round | no-repeat ]{1,2}

mask-repeat controla a repetição das imagens de máscara depois de serem definidos o seu tamanho e a sua posição. O valor inicial é repeat; a propriedade não é herdada e a sua animação é discreta. mask-image fornece a imagem, mask-size define o tamanho do mosaico e mask-position a sua posição.

Um único valor entre repeat, space, round e no-repeat aplica-se aos dois eixos. Com dois valores, o primeiro controla o eixo horizontal e o segundo o vertical. repeat-x significa repeat no-repeat, e repeat-y significa no-repeat repeat. repeat repete os mosaicos, que podem ser cortados nos limites; no-repeat apresenta uma única cópia nesse eixo.

space coloca o maior número possível de mosaicos completos sem os redimensionar e distribui o espaço restante entre eles. Se couberem pelo menos dois, os mosaicos das extremidades tocam nos limites da área de posicionamento; se só couber um, mask-position é relevante. round redimensiona os mosaicos para que caiba um número inteiro.

As vírgulas separam as definições das camadas mask-image sucessivas; uma lista demasiado curta é repetida. A propriedade não tem efeito numa camada que faça referência a um elemento SVG mask. No exemplo, a metade transparente de cada mosaico oculta o elemento e deixa ver a página branca.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>mask-repeat</title>
<style>
  body { background: white; }
  .sample {
    width: 160px;
    height: 80px;
    background: #0066cc;
    mask-image: linear-gradient(to right, black 50%, transparent 50%);
    mask-mode: alpha;
    mask-size: 40px 80px;
    mask-position: 0 0;
    mask-repeat: repeat-x;
  }
</style>
<div class="sample"></div>

Resultado

Four blue vertical stripes, each 20 CSS px wide and 80 CSS px high, separated by 20 CSS px transparent gaps showing the white page.

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