Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti