CKTIS / CSS
saturate(): Sättigung des gerenderten Bildes ändern
Wende einen Farbmatrixfilter auf gezeichnete Inhalte an, ohne Layout oder Quellfarben zu verändern.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
filter: saturate(200%);Innerhalb von filter passt saturate() die Sättigung der gerenderten Eingabe an. Das Argument ist eine nichtnegative Zahl oder Prozentangabe: 0 entfernt die Sättigung, 1 oder 100% lässt Farben unverändert, und Werte über 100% verstärken den Effekt. Ein ausgelassenes Argument ist standardmäßig 1. Ein negatives Argument ist ungültig; es kehrt den Effekt nicht um.
Dies ist eine Matrixoperation auf RGB-Kanälen, keine Änderung der Sättigungskomponente einer HSL-Farbe. Der ursprüngliche Farbton oder die Helligkeit bleiben nicht zwingend erhalten, und Kanäle können an ihren Grenzen abgeschnitten werden. Auf einem Element wirkt der Filter auf dessen gezeichnete Inhalte einschließlich der Nachfahren, ohne das Layout neu anzuordnen oder die ursprüngliche Bilddatei und CSS-Farbdeklarationen umzuschreiben. Er liefert keinen neuen Farbwert für die Eigenschaft color.
Das Beispiel rastert tatsächlich ein Rechteck in der Farbe 120,80,40 und liest seine Pixel. In Chromium 157 ergibt 0 das Grau 86,86,86; 1 und ein ausgelassenes Argument erhalten 120,80,40; 200% ergibt 154,74,0. Alpha bleibt in diesen undurchsichtigen Proben 255. Der Blaukanal erreicht seine Untergrenze und zeigt damit, warum stärkere Sättigung keine einfache prozentuale Erhöhung jedes Kanals ist. Die Prüfung der negativen Syntax liefert false.
Beispiele
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)'));Ergebnis
0=86,86,86,255 1=120,80,40,255 200%=154,74,0,255 omitted=120,80,40,255 negative=false
Dies sind abgetastete gerenderte Pixel, nicht nur akzeptierte CSS-Deklarationen. Exakte ganzzahlige Kanäle spiegeln Rasterung und Rundung im dokumentierten Browser wider; Identität und Gleichheit der Graukanäle sind die wesentlichen Prüfungen.