Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

sepia(): odstupňovaný barevný filtr v sépiových tónech

Použijte sépiový převod a rozlište vynechaný argument, nulu a hodnoty nad 100%.

Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

filter: sepia(50%);

sepia(amount) posouvá vykreslené barvy směrem k sépiové paletě. Nula ponechává vstup beze změny, 100% nebo 1 provede celý převod a mezilehlé hodnoty efekt odstupňují. Vynechaný argument v sepia() znamená 1. Hodnoty nad 100% jsou přijaty, ale omezeny na plný efekt; záporné hodnoty jsou neplatné.

Filtr působí na vykreslený prvek, takže může společně zasáhnout text, pozadí i potomky. Neupravuje soubor obrázku ani rozměry prvku v rozvržení. Kombinace s jinými filtry se provádí podle pořadí seznamu a může změnit výsledek. Na rozdíl od saturate() vyšší přijaté hodnoty efekt nad maximum nezvyšují.

Příklad vykreslí neprůhlednou plochu RGB(80,120,160) a vzorkuje ji cestou SVG/canvas v prohlížeči. V Chromium 157 jsou naměřené hodnoty RGBA 80,120,160,255 při nule, 117,129,133,255 při polovině a 154,137,107,255 při plném efektu. Prázdné závorky a 200% dávají stejný plný výsledek; záporný zápis neprojde CSS.supports().

Příklady

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)'));

Výsledek

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

Jde o změřené pixely z uvedené vykreslovací cesty, ne příslib stejných bajtů v každém grafickém řetězci. Nezměněná alfa a shoda plného, vynechaného i nadlimitního argumentu ukazují důležité rozdíly.

Zdroje