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

CKTIS / CSS

filter — effets graphiques CSS

La propriété filter traite un élément et ses descendants comme une image, à l’aide de fonctions d’effet ou de références à des filtres SVG.

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

Syntaxe

filter: none | [ <filter-function> | <url> ]+;

filter modifie le rendu d’un élément et de ses descendants en tant que groupe. Cette propriété n’est pas héritée ; sa valeur initiale est none, c’est-à-dire aucun effet. Elle ne modifie pas la géométrie des boîtes CSS.

Séparez par des espaces les fonctions telles que blur(4px) et invert(100%). Elles sont exécutées dans l’ordre indiqué ; le résultat de l’une sert d’entrée à la suivante. url(#effect) fait référence à un filtre SVG. Une cible inexistante désactive toute la chaîne.

Toute valeur autre que none crée un contexte d’empilement et un bloc conteneur pour les descendants positionnés de façon absolue ou en fixed ; la racine du document fait exception à la règle du bloc conteneur. Cela inclut aussi des valeurs visuellement neutres comme blur(0px).

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>filter: invert a red swatch</title>
  <style>
    .samples {
      display: flex;
      flex-flow: row nowrap;
      gap: 0.5rem;
      max-width: calc(240px + 0.5rem);
    }
    .sample {
      flex: 1 1 120px;
      min-width: 0;
      height: 80px;
      background: #f00;
    }
    #filtered { filter: invert(100%); }
  </style>
</head>
<body>
  <div class="samples">
    <div class="sample" id="original" role="img" aria-label="Original red swatch"></div>
    <div class="sample" id="filtered" role="img" aria-label="Red swatch with an invert filter"></div>
  </div>
  <script>
    const original = document.getElementById('original');
    const filtered = document.getElementById('filtered');
    console.log(`Left filter: ${getComputedStyle(original).filter}`);
    console.log(`Right filter: ${getComputedStyle(filtered).filter}`);
  </script>
</body>
</html>

Résultat

Left filter: none
Right filter: invert(1)

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources