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

CKTIS / CSS

sepia(): um filtro de cor gradual em tons castanhos

Aplica uma conversão sépia à imagem renderizada e distingue a omissão, o zero e os valores acima de 100%.

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

Sintaxe

filter: sepia(50%);

sepia(amount) converte as cores renderizadas para uma paleta sépia. Zero mantém as cores de entrada inalteradas, 100% ou 1 aplica a conversão completa e os valores intermédios graduam o efeito. O argumento omitido em sepia() significa 1. Os valores superiores a 100% são aceites, mas limitados ao efeito completo; os valores negativos são inválidos.

É um filtro aplicado ao elemento renderizado, pelo que pode afetar em conjunto o texto, o fundo e os descendentes. Não modifica um ficheiro de imagem nem altera as dimensões de disposição do elemento. A combinação de sépia com outros filtros aplica a lista pela ordem indicada e pode alterar o resultado. Ao contrário de saturate(), valores aceites mais elevados não aumentam este efeito para além do seu máximo.

O exemplo desenha uma área opaca RGB(80,120,160) e recolhe amostras através do percurso de renderização SVG/canvas do navegador. No Chromium 157, os valores RGBA medidos são 80,120,160,255 com zero, 117,129,133,255 a meia intensidade e 154,137,107,255 à intensidade máxima. Os parênteses vazios e 200% correspondem ao resultado completo; a forma negativa não passa CSS.supports().

Exemplos

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

Resultado

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

São píxeis medidos no percurso de renderização indicado, não valores de bytes universais garantidos para qualquer cadeia de processamento gráfico. O alfa inalterado e a correspondência entre as amostras do efeito completo, do argumento omitido e do valor excessivo demonstram as distinções pretendidas.

Fontes