Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti