Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti