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.