<filter-function>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Le type de donnée <filter-function> représente un effet graphique qui peut modifier l'apparence d'une image. Il est notamment utilisé avec les propriétés filter et backdrop-filter.

Syntaxe

Une valeur de type <filter-function> se construit avec l'une des fonctions listées ci-après. Chaque fonction utilise un argument et si celui-ci est invalide, aucun filtre n'est appliqué.

blur(): Ajoute un flou sur l'image.
brightness(): Rend l'image plus claire ou plus sombre.
contrast(): Augmente ou diminue le contraste de l'image.
drop-shadow(): Applique une ombre portée derrière l'image.
grayscale(): Convertit l'image en niveaux de gris.
hue-rotate(): Modifie la teinte globale de l'image.
invert(): Inverse les couleurs de l'image.
opacity(): Rend l'image transparente.
saturate(): Sursature ou désature l'image.
sepia(): Convertit l'image en sépia.

Cet exemple fournit une image ainsi qu'un menu pour expérimenter les différentes fonctions de filtres avec un curseur pour faire varier la valeur du paramètre. En jouant sur le curseur et la fonction utilisée, l'image est mise à jour en temps réel, vous permettant de voir l'effet des différents filtres.

HTML

html

<div></div>
<ul>
  <li>
    <label for="filter-select">Choisissez une fonction de filtre&nbsp;:</label>
    <select id="filter-select">
      <option selected>blur</option>
      <option>brightness</option>
      <option>contrast</option>
      <option>drop-shadow</option>
      <option>grayscale</option>
      <option>hue-rotate</option>
      <option>invert</option>
      <option>opacity</option>
      <option>saturate</option>
      <option>sepia</option>
    </select>
  </li>
  <li><input type="range" /><output></output></li>
  <li>
    <p>Valeur CSS actuelle&nbsp;: <code></code></p>
  </li>
</ul>

CSS

css

div {
  width: 300px;
  height: 300px;
  background: url(https://mdn.dev/archives/media/attachments/2020/07/29/17350/3b4892b7e820122ac6dd7678891d4507/firefox.png)
    no-repeat center;
}

li {
  display: flex;
  align-items: center;
  justify-content: center;
  margin-bottom: 20px;
}

input {
  width: 60%;
}

output {
  width: 5%;
  text-align: center;
}

select {
  width: 40%;
  margin-left: 2px;
}

JavaScript

const selectElem = document.querySelector("select");
const divElem = document.querySelector("div");
const slider = document.querySelector("input");
const output = document.querySelector("output");
const curValue = document.querySelector("p code");

selectElem.addEventListener("change", () => {
  setSlider(selectElem.value);
  setDiv(selectElem.value);
});

slider.addEventListener("input", () => {
  setDiv(selectElem.value);
});

function setSlider(filter) {
  if (filter === "blur") {
    slider.value = 0;
    slider.min = 0;
    slider.max = 30;
    slider.step = 1;
    slider.setAttribute("data-unit", "px");
  } else if (
    filter === "brightness" ||
    filter === "contrast" ||
    filter === "saturate"
  ) {
    slider.value = 1;
    slider.min = 0;
    slider.max = 4;
    slider.step = 0.05;
    slider.setAttribute("data-unit", "");
  } else if (filter === "drop-shadow") {
    slider.value = 0;
    slider.min = -20;
    slider.max = 40;
    slider.step = 1;
    slider.setAttribute("data-unit", "px");
  } else if (filter === "opacity") {
    slider.value = 1;
    slider.min = 0;
    slider.max = 1;
    slider.step = 0.01;
    slider.setAttribute("data-unit", "");
  } else if (
    filter === "grayscale" ||
    filter === "invert" ||
    filter === "sepia"
  ) {
    slider.value = 0;
    slider.min = 0;
    slider.max = 1;
    slider.step = 0.01;
    slider.setAttribute("data-unit", "");
  } else if (filter === "hue-rotate") {
    slider.value = 0;
    slider.min = 0;
    slider.max = 360;
    slider.step = 1;
    slider.setAttribute("data-unit", "deg");
  }
}

function setDiv(filter) {
  if (filter === "drop-shadow") {
    divElem.style.filter = `${selectElem.value}(${Math.round(
      slider.value,
    )}${slider.getAttribute("data-unit")} ${Math.round(
      slider.value,
    )}${slider.getAttribute("data-unit")} ${Math.round(
      Math.abs(slider.value / 2),
    )}${slider.getAttribute("data-unit")})`;
  } else {
    divElem.style.filter = `${selectElem.value}(${
      slider.value
    }${slider.getAttribute("data-unit")}`;
  }

  updateOutput();
  updateCurValue();
}

function updateOutput() {
  output.textContent = slider.value;
}

function updateCurValue() {
  curValue.textContent = `filter: ${divElem.style.filter}`;
}

setSlider(selectElem.value);
setDiv(selectElem.value);

Résultat

Spécifications

Specification
Filter Effects Module Level 1 # typedef-filter-function

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

Les propriétés qui utilisent ce type de donnée :
- filter
- backdrop-filter