Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

saturate() : modifier la saturation de l’image rendue

Applique un filtre matriciel aux couleurs dessinées sans changer la mise en page ni les couleurs sources.

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

Syntaxe

filter: saturate(200%);

Dans filter, saturate() ajuste la saturation de l’entrée rendue. L’argument est un nombre ou un pourcentage non négatif : 0 supprime la saturation, 1 ou 100% laisse les couleurs inchangées et les valeurs supérieures à 100% renforcent l’effet. Un argument omis vaut 1. Un argument négatif est invalide ; il n’inverse pas l’effet.

Il s’agit d’une opération matricielle sur les canaux RGB, pas d’une modification de la composante de saturation d’une couleur HSL. Elle ne préserve pas nécessairement la teinte ou la luminosité d’origine, et les canaux peuvent être écrêtés à leurs limites. Appliqué à un élément, le filtre agit sur son contenu dessiné, descendants compris, sans réorganiser la mise en page ni réécrire le fichier image initial ou les déclarations de couleur CSS. Il ne fournit pas une nouvelle valeur de couleur pour la propriété color.

L’exemple rastérise réellement un rectangle coloré 120,80,40 et lit ses pixels. Dans Chromium 157, 0 donne le gris 86,86,86 ; 1 et un argument omis conservent 120,80,40 ; 200% donne 154,74,0. Alpha reste à 255 dans ces échantillons opaques. Le canal bleu atteint sa limite basse : une saturation accrue n’est donc pas une simple hausse proportionnelle de chaque canal. Le contrôle de syntaxe négative renvoie false.

Exemples

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

Résultat

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

Ce sont des pixels rendus échantillonnés, pas seulement des déclarations CSS acceptées. Les valeurs entières exactes reflètent la rastérisation et les arrondis du navigateur enregistré ; l’identité et l’égalité des canaux gris constituent les contrôles essentiels.

Sources