[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/CSS/Reference/Values/filter-function/saturate [Back]  [Original]

Fonction CSS saturate() - CSS | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Fonction CSS saturate()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2016.

La fonction CSS saturate() permet d'accentuer ou de rduire la saturation d'une image. Le rsultat de cette fonction est une valeur <filter-function>.

Dans cet article

Exemple interactif

filter: saturate(1);
filter: saturate(4);
filter: saturate(50%);
filter: saturate(0);
<section id="default-example">
  <img
    class="transition-all"
    id="example-element"
    src="/shared-assets/images/examples/firefox-logo.svg"
    width="200" />
</section>

Syntaxe

css
saturate(amount)

Paramtres

amount Facultatif

Niveau de saturation, exprim en nombre (<number>) ou en pourcentage (<percentage>). Une valeur infrieure 100% dsature l'image, tandis qu'une valeur suprieure 100% la sursature. Une valeur de 0% rend l'image totalement dsature, tandis qu'une valeur de 100% laisse l'image inchange. La valeur initiale utilise pour l'interpolation est 1. La valeur par dfaut est 1.

Syntaxe formelle

<saturate()> = 
saturate( [ <number> | <percentage> ]? )
Cette syntaxe reflte le dernier standard selon Filter Effects Module Level 1. Tous les navigateurs n'ont peut-tre pas implment toutes les parties. Voir la Compatibilit des navigateurs pour plus d'informations sur la prise en charge.

Exemples

Exemples de valeurs correctes pour saturate()

css
saturate(0);    /* Compltement sous-sature */
saturate(.4);   /* Sous-sature  40% */
saturate()      /* Aucun effet */
saturate(100%);
saturate(200%); /* Saturation double */

saturate() ne prserve pas la teinte ni la luminosit

Le diagramme ci-dessous compare deux dgrads de couleurs ayant hsl(0 50% 50%) comme point central : le premier est gnr avec saturate(), le second utilise de vraies valeurs HSL. Remarquez que le dgrad obtenu avec saturate() prsente des diffrences de teinte et de luminosit aux extrmits.

html
<div>
  <p>Avec <code>saturate()</code></p>
  <div id="saturate"></div>
</div>
<div>
  <p>Avec <code>hsl()</code></p>
  <div id="hsl"></div>
</div>
js
const saturate = document.getElementById("saturate");
const hsl = document.getElementById("hsl");

for (let i = 0; i <= 200; i++) {
  const div1 = document.createElement("div");
  div1.style.backgroundColor = `hsl(0 ${i / 2}% 50%)`;
  hsl.appendChild(div1);

  const div2 = document.createElement("div");
  div2.style.backgroundColor = "hsl(0 50% 50%)";
  div2.style.filter = `saturate(${i}%)`;
  saturate.appendChild(div2);
}

Spcifications

Spcification
Filter Effects Module Level 1
# funcdef-filter-saturate

Compatibilit des navigateurs

Voir aussi

Les autres fonctions <filter-function> pouvant tre utilises dans les valeurs des proprits filter et backdrop-filter sont :


Web Proxy Viewer  |  New URL  |  Original Page