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

CKTIS / CSS

grayscale() — conversion proportionnelle en gris

`grayscale()` mélange les composantes d’une image d’entrée vers leur luminance et règle la quantité de saturation supprimée.

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

Syntaxe

grayscale( [ <number> | <percentage> ]? )

grayscale() mélange les composantes d’une image d’entrée vers leur luminance et règle la quantité de saturation supprimée.

L’exemple traite un pixel rouge : grayscale(50%) donne 155,27,27, tandis que grayscale(100%) donne 54,54,54. grayscale(200%) produit le même résultat complet car les valeurs excédentaires sont bornées ; grayscale(-1) est invalide.

Grammaire: grayscale( [ <number> | <percentage> ]? ).

L’argument peut être un nombre ou un pourcentage : 0 laisse l’image inchangée et 1 signifie une conversion complète. L’argument omis vaut 1, les valeurs intermédiaires mélangent linéairement l’effet, celles au-dessus de 1 sont bornées à 1 et les négatives interdites. Le filtre agit sur le tampon rendu sans changer la mise en page ni les données de l’image source.

Exemples

const sample=async filter=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="4" height="4"><foreignObject width="4" height="4"><div xmlns="http://www.w3.org/1999/xhtml" style="width:4px;height:4px;background:rgb(255 0 0);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=4;const context=canvas.getContext('2d');context.drawImage(image,0,0);return [...context.getImageData(2,2,1,1).data].slice(0,3).join(',')};
const half=await sample('grayscale(50%)');
const full=await sample('grayscale(100%)');
const over=await sample('grayscale(200%)');
const negative=CSS.supports('filter','grayscale(-1)');
console.log('half='+half+'; full='+full+'; over='+over+'; negative='+negative);

Résultat

half=155,27,27; full=54,54,54; over=54,54,54; negative=false

`grayscale()` mélange les composantes d’une image d’entrée vers leur luminance et règle la quantité de saturation supprimée.

Sources