CKTIS / CSS
sepia(): un filtro cromatico graduato sui toni del marrone
Applica una conversione seppia all’immagine renderizzata e distingui omissione, zero e valori oltre il 100%.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
filter: sepia(50%);sepia(amount) converte i colori renderizzati verso una tavolozza seppia. Zero lascia invariati i colori in ingresso, 100% o 1 applica la conversione completa e i valori intermedi dosano l’effetto. L’argomento omesso in sepia() vale 1. I valori superiori al 100% sono accettati ma limitati all’effetto completo; quelli negativi non sono validi.
È un filtro sull’elemento renderizzato, quindi può influire contemporaneamente sul testo, sullo sfondo e sui discendenti. Non modifica un file immagine né le dimensioni di layout dell’elemento. Combinare seppia con altri filtri applica la lista in ordine e può cambiare il risultato. A differenza di saturate(), valori accettati più elevati non aumentano l’effetto oltre il suo massimo.
L’esempio disegna una zona opaca RGB(80,120,160) e la campiona attraverso il percorso di rendering SVG/canvas del browser. In Chromium 157 i valori RGBA campionati sono 80,120,160,255 a zero, 117,129,133,255 a metà intensità e 154,137,107,255 alla massima intensità. Le parentesi vuote e 200% corrispondono al risultato completo; la forma negativa non supera CSS.supports().
Esempi
async function sample(filter) {
const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><foreignObject width="8" height="8"><div xmlns="http://www.w3.org/1999/xhtml" style="width:8px;height:8px;background:rgb(80 120 160);filter:'+filter+'"></div></foreignObject></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 context=canvas.getContext('2d');context.drawImage(image,0,0);
return [...context.getImageData(4,4,1,1).data].join(',');
}
const normal=await sample('sepia(0)');
const half=await sample('sepia(50%)');
const full=await sample('sepia(1)');
const omitted=await sample('sepia()');
const over=await sample('sepia(200%)');
console.log('normal='+normal+'; half='+half+'; full='+full+'; omitted='+omitted+'; over='+over+'; negative='+CSS.supports('filter','sepia(-0.1)'));Risultato
normal=80,120,160,255; half=117,129,133,255; full=154,137,107,255; omitted=154,137,107,255; over=154,137,107,255; negative=false
Sono pixel misurati nel percorso di rendering indicato, non valori di byte universali garantiti per ogni pipeline grafica. L’alfa invariato e la corrispondenza tra i campioni con effetto completo, argomento omesso e valore eccessivo dimostrano le distinzioni previste.