CKTIS / CSS
mask-repeat — ripetere un’immagine di maschera
La proprietà mask-repeat controlla se e come un’immagine di maschera si ripete in orizzontale e in verticale. Permette di mostrare una singola maschera, creare motivi regolari oppure modificare la spaziatura o le dimensioni dei motivi.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
mask-repeat: <repeat-style>#;
<repeat-style> = repeat-x | repeat-y | [ repeat | space | round | no-repeat ]{1,2}mask-repeat controlla la ripetizione delle immagini di maschera dopo averne stabilito dimensioni e posizione. Il valore iniziale è repeat; la proprietà non è ereditata e la sua animazione è discreta. mask-image fornisce l’immagine, mask-size imposta le dimensioni del motivo e mask-position la sua posizione.
Un solo valore tra repeat, space, round e no-repeat si applica a entrambi gli assi. Con due valori, il primo controlla l’asse orizzontale e il secondo quello verticale. repeat-x significa repeat no-repeat, mentre repeat-y significa no-repeat repeat. repeat ripete i motivi, che possono essere ritagliati ai bordi; no-repeat mostra una sola copia lungo l’asse corrispondente.
space dispone il maggior numero possibile di motivi interi senza ridimensionarli e distribuisce lo spazio rimanente tra loro. Se ne entrano almeno due, i motivi alle estremità toccano i bordi dell’area di posizionamento; se ne entra uno solo, conta mask-position. round ridimensiona i motivi in modo che ne entri un numero intero.
Le virgole separano le impostazioni dei livelli mask-image successivi; se l’elenco è troppo breve, viene ripetuto. La proprietà non ha effetto su un livello che fa riferimento a un elemento SVG mask. Nell’esempio, la metà trasparente di ogni motivo nasconde l’elemento e lascia vedere la pagina bianca.
Esempi
<!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>Risultato
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.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.