Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

filter — efeitos gráficos CSS

A propriedade filter processa um elemento e os seus descendentes como uma imagem, usando funções de efeito ou referências a filtros SVG.

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

Sintaxe

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

filter altera a representação de um elemento e dos seus descendentes como grupo. Não é herdada; o seu valor inicial é none, ou seja, nenhum efeito. Não altera a geometria das caixas CSS.

Separe com espaços funções como blur(4px) e invert(100%). São executadas pela ordem indicada; o resultado de uma é a entrada da seguinte. url(#effect) referencia um filtro SVG. Se o destino não existir, toda a cadeia é desativada.

Um valor diferente de none cria um contexto de empilhamento e um bloco contêiner para descendentes posicionados de forma absoluta e descendentes fixed; a raiz do documento é uma exceção à regra do bloco contêiner. Isto inclui também valores visualmente neutros como blur(0px).

Exemplos

<!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>

Resultado

Left filter: none
Right filter: invert(1)

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes