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

CKTIS / CSS

saturate(): alterar a saturação da imagem renderizada

Aplica um filtro matricial ao conteúdo desenhado sem alterar a disposição nem as cores originais.

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

Sintaxe

filter: saturate(200%);

Em filter, saturate() ajusta a saturação da entrada renderizada. O argumento é um número ou uma percentagem não negativa: 0 remove a saturação, 1 ou 100% deixa as cores inalteradas e valores acima de 100% intensificam o efeito. Um argumento omitido vale 1. Um argumento negativo é inválido; não inverte o efeito.

É uma operação matricial sobre os canais RGB, não uma edição da componente de saturação de uma cor HSL. Não tem de preservar a tonalidade ou a luminosidade originais, e os canais podem ser limitados aos extremos do seu intervalo. Aplicado a um elemento, o filtro afeta o conteúdo desenhado, incluindo os descendentes, sem reorganizar a disposição nem reescrever o ficheiro de imagem original ou as declarações de cor CSS. Não fornece um novo valor de cor à propriedade color.

O exemplo rasteriza realmente um retângulo com a cor 120,80,40 e lê os seus píxeis. No Chromium 157, 0 produz o cinzento 86,86,86; 1 e um argumento omitido preservam 120,80,40; 200% produz 154,74,0. Alfa mantém-se em 255 nestas amostras opacas. O canal azul atinge o limite inferior, mostrando que mais saturação não é um simples aumento percentual de cada canal. A verificação da sintaxe negativa devolve false.

Exemplos

const pixel=async amount=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><rect width="8" height="8" fill="rgb(120,80,40)" style="filter:saturate('+amount+')"/></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 ctx=canvas.getContext('2d');ctx.drawImage(image,0,0);return [...ctx.getImageData(4,4,1,1).data].join(',')};
for(const amount of ['0','1','200%',''])console.log((amount||'omitted')+'='+await pixel(amount));
console.log('negative='+CSS.supports('filter','saturate(-1)'));

Resultado

0=86,86,86,255
1=120,80,40,255
200%=154,74,0,255
omitted=120,80,40,255
negative=false

São amostras de píxeis renderizados, não apenas declarações CSS aceites. Os valores inteiros exatos refletem a rasterização e o arredondamento no navegador registado; a identidade e a igualdade dos canais de cinzento são as verificações essenciais.

Fontes