CKTIS / CSS
saturate(): cambiare la saturazione dell’immagine renderizzata
Applica un filtro a matrice al contenuto disegnato senza cambiare layout o colori sorgenti.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
filter: saturate(200%);Dentro filter, saturate() regola la saturazione dell’immagine renderizzata in ingresso. L’argomento è un numero o una percentuale non negativa: 0 elimina la saturazione, 1 o 100% lascia invariati i colori e valori superiori al 100% intensificano l’effetto. L’argomento omesso vale 1. Un argomento negativo non è valido e non inverte l’effetto.
È un’operazione matriciale sui canali RGB, non una modifica della componente di saturazione di un colore HSL. Non deve necessariamente conservare tonalità o luminosità originali e i canali possono essere troncati ai loro limiti. Applicato a un elemento, il filtro coinvolge il contenuto disegnato, inclusi i discendenti, senza ridisporre il layout né riscrivere il file immagine originale o le dichiarazioni CSS dei colori. Non fornisce un nuovo valore di colore per la proprietà color.
L’esempio rasterizza realmente un rettangolo di colore 120,80,40 e ne legge i pixel. In Chromium 157, 0 produce il grigio 86,86,86; 1 e l’argomento omesso conservano 120,80,40; 200% produce 154,74,0. Alfa rimane 255 in questi campioni opachi. Il canale blu raggiunge il limite inferiore: una saturazione maggiore non è un semplice aumento percentuale di ciascun canale. Il controllo della sintassi negativa restituisce false.
Esempi
const pixel=async amount=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><rect width="8" height="8" fill="rgb(120,80,40)" style="filter:saturate('+amount+')"/></svg>';const image=new Image();image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(svg);await image.decode();const canvas=document.createElement('canvas');canvas.width=canvas.height=8;const ctx=canvas.getContext('2d');ctx.drawImage(image,0,0);return [...ctx.getImageData(4,4,1,1).data].join(',')};
for(const amount of ['0','1','200%',''])console.log((amount||'omitted')+'='+await pixel(amount));
console.log('negative='+CSS.supports('filter','saturate(-1)'));Risultato
0=86,86,86,255 1=120,80,40,255 200%=154,74,0,255 omitted=120,80,40,255 negative=false
Sono campioni di pixel renderizzati, non soltanto dichiarazioni CSS accettate. I valori interi esatti riflettono rasterizzazione e arrotondamento nel browser registrato; identità e uguaglianza dei canali del grigio sono le verifiche essenziali.