KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

saturate(): de verzadiging van het gerenderde beeld aanpassen

Pas een kleurmatrixfilter toe op getekende inhoud zonder de layout of bronkleuren te veranderen.

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

Syntax

filter: saturate(200%);

Binnen filter past saturate() de verzadiging van de gerenderde invoer aan. Het argument is een niet-negatief getal of percentage: 0 verwijdert verzadiging, 1 of 100% laat kleuren ongewijzigd en waarden boven 100% versterken het effect. Een weggelaten argument is standaard 1. Een negatief argument is ongeldig en keert het effect niet om.

Dit is een matrixbewerking op RGB-kanalen, geen aanpassing van de verzadigingscomponent van een HSL-kleur. De oorspronkelijke tint of lichtheid blijft niet noodzakelijk behouden en kanalen kunnen op hun grenzen worden afgeknipt. Op een element beïnvloedt het filter de getekende inhoud inclusief afstammelingen, zonder de layout te herschikken of het oorspronkelijke afbeeldingsbestand en de CSS-kleurdeclaraties te herschrijven. Het levert geen nieuwe kleurwaarde voor de eigenschap color.

Het voorbeeld rastert daadwerkelijk een rechthoek met kleur 120,80,40 en leest de pixels. In Chromium 157 geeft 0 het grijs 86,86,86; 1 en een weggelaten argument behouden 120,80,40; 200% geeft 154,74,0. Alfa blijft 255 in deze ondoorzichtige monsters. Het blauwe kanaal bereikt zijn ondergrens: meer verzadiging is dus geen eenvoudige procentuele verhoging van ieder kanaal. De controle van negatieve syntaxis geeft false.

Voorbeelden

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

Resultaat

0=86,86,86,255
1=120,80,40,255
200%=154,74,0,255
omitted=120,80,40,255
negative=false

Dit zijn bemonsterde gerenderde pixels, niet alleen geaccepteerde CSS-declaraties. Exacte gehele kanaalwaarden weerspiegelen rastering en afronding in de vastgelegde browser; identiteit en gelijkheid van de grijze kanalen zijn de belangrijkste controles.

Bronnen