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

CKTIS / CSS

sepia() : un filtre coloré gradué dans les tons bruns

Appliquez une conversion sépia à l’image rendue et distinguez l’omission, zéro et les valeurs au-delà de 100%.

Version : 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) convertit les couleurs rendues vers une palette sépia. Zéro laisse les couleurs d’entrée inchangées, 100% ou 1 applique la conversion complète, et les valeurs intermédiaires dosent l’effet. L’argument omis dans sepia() signifie 1. Les valeurs supérieures à 100% sont acceptées mais limitées à l’effet complet ; les valeurs négatives sont invalides.

Ce filtre agit sur l’élément rendu et peut donc affecter ensemble son texte, son arrière-plan et ses descendants. Il ne modifie pas un fichier image ni les dimensions de mise en page de l’élément. Combiner sépia avec d’autres filtres les applique dans l’ordre de la liste et peut changer le résultat. Contrairement à saturate(), des valeurs admises plus grandes n’intensifient pas cet effet au-delà de son maximum.

L’exemple dessine une zone opaque RGB(80,120,160) et en prélève un pixel par le chemin de rendu SVG/canvas du navigateur. Dans Chromium 157, les valeurs RGBA mesurées sont 80,120,160,255 à zéro, 117,129,133,255 à mi-intensité et 154,137,107,255 à pleine intensité. Les parenthèses vides et 200% donnent le même résultat complet ; la forme négative échoue à CSS.supports().

Exemples

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

Résultat

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

Il s’agit de pixels mesurés dans le chemin de rendu indiqué, pas de valeurs d’octets universelles promises pour tous les pipelines graphiques. L’alpha inchangé et la concordance des mesures à effet complet, argument omis et dépassement montrent les distinctions recherchées.

Sources