CKTIS / CSS
mask-size — dimensioni delle immagini della maschera
La proprietà mask-size imposta le dimensioni delle immagini dei livelli di maschera, non quelle dell’elemento. Accetta lunghezze, percentuali, auto, contain e cover; per più livelli si possono specificare dimensioni separate.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;mask-size ridimensiona le immagini fornite da mask-image senza modificare le dimensioni dell’elemento nel layout. Il valore iniziale è auto e la proprietà non viene ereditata. Da sola non crea una maschera.
Una lunghezza o una percentuale specifica la larghezza, mentre l’altezza diventa auto; due valori specificano rispettivamente larghezza e altezza. I valori negativi non sono validi. Le percentuali si riferiscono alle dimensioni corrispondenti dell’area di posizionamento della maschera, determinata da mask-origin, non alle dimensioni del file immagine.
auto usa le dimensioni naturali e le proporzioni dell’immagine, se disponibili. Con auto auto, un gradiente privo di dimensioni naturali riempie l’area di posizionamento. contain mantiene le proporzioni e adatta l’intera immagine all’area; cover mantiene le proporzioni e copre tutta l’area, quindi una parte dell’immagine può fuoriuscirne. Due dimensioni esplicite possono deformare le proporzioni.
Le dimensioni di più livelli si separano con virgole e seguono l’ordine di mask-image. Se l’elenco è troppo corto, viene ripetuto; i valori in eccesso vengono ignorati. mask-repeat controlla separatamente la ripetizione dell’immagine. Eccezione importante: se la sorgente è un elemento SVG mask, mask-size non ha effetto su quel livello; la geometria è definita dall’elemento stesso.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>mask-size</title>
<style>
body { margin: 20px; background: white; }
.sample {
width: 240px;
height: 120px;
background: #0066cc;
mask-image: linear-gradient(black, black);
mask-mode: alpha;
mask-origin: border-box;
mask-size: 50% 100%;
mask-position: center;
mask-repeat: no-repeat;
}
</style>
<div class="sample"></div>Risultato
A 120 × 120 CSS-pixel blue square is visible, centered horizontally within a 240 × 120 CSS-pixel element; the remaining area shows the white page background.
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.