Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

mask-position — posizionare un’immagine di maschera

La proprietà mask-position stabilisce la posizione dell’immagine di ogni livello della maschera. Accetta parole chiave, lunghezze e percentuali; non sposta l’elemento né ne modifica il layout.

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

Sintassi

mask-position: <position>#;

mask-position posiziona le immagini della maschera rispetto all’area stabilita da mask-origin. Il valore iniziale è 0% 0% e la proprietà non è ereditata. La sintassi <position># indica un elenco di posizioni separate da virgole, assegnate ai successivi livelli mask-image.

I valori includono center, left top, 20px 10px e right 20px bottom 10px. Con due lunghezze, la prima specifica lo spostamento orizzontale e la seconda quello verticale. Un singolo valore, come left, lascia centrato l’altro asse. Le percentuali allineano punti corrispondenti dell’immagine e dell’area di posizionamento: 50% 50% centra l’immagine. Lo spostamento su ciascun asse è (dimensione dell’area - dimensione dell’immagine) × percentuale; se le dimensioni sono uguali, le percentuali non producono spostamenti.

mask-size imposta le dimensioni dell’immagine, mentre mask-repeat ne controlla la ripetizione. Nell’esempio, no-repeat permette di vedere un solo rettangolo di maschera. La mascheratura modifica la visibilità, non le dimensioni del riquadro di layout. Se mask-image fa riferimento a un elemento SVG mask, mask-position non ha effetto su quel livello.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>mask-position</title>
<style>
  body { margin: 0; background: white; }
  .sample {
    width: 200px;
    height: 120px;
    background: #0066cc;
    mask-image: linear-gradient(black, black);
    mask-mode: alpha;
    mask-origin: border-box;
    mask-clip: border-box;
    mask-size: 80px 40px;
    mask-repeat: no-repeat;
    mask-position: right 20px bottom 10px;
  }
</style>
<div class="sample"></div>

Risultato

Expected visual geometry in CSS pixels: a blue 80 × 40 rectangle with its top-left corner at (100, 70), on a white page. The element retains its 200 × 120 layout box.

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