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.