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

CKTIS / CSS

grayscale() — conversão proporcional para cinzento

`grayscale()` mistura os componentes de uma imagem na direção da luminância e controla quanta saturação é removida.

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

Sintaxe

grayscale( [ <number> | <percentage> ]? )

grayscale() mistura os componentes de uma imagem na direção da luminância e controla quanta saturação é removida.

O exemplo processa um píxel vermelho: grayscale(50%) dá 155,27,27, enquanto grayscale(100%) dá 54,54,54. grayscale(200%) produz o mesmo resultado completo porque os valores superiores são limitados; grayscale(-1) é inválida.

Gramática: grayscale( [ <number> | <percentage> ]? ).

O argumento pode ser número ou percentagem: 0 não altera a imagem e 1 significa conversão completa. Se omitido vale 1, valores intermédios misturam linearmente o efeito, acima de 1 são limitados a 1 e negativos são proibidos. O filtro atua no buffer representado sem alterar a disposição nem os dados da imagem original.

Exemplos

const sample=async filter=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="4" height="4"><foreignObject width="4" height="4"><div xmlns="http://www.w3.org/1999/xhtml" style="width:4px;height:4px;background:rgb(255 0 0);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=4;const context=canvas.getContext('2d');context.drawImage(image,0,0);return [...context.getImageData(2,2,1,1).data].slice(0,3).join(',')};
const half=await sample('grayscale(50%)');
const full=await sample('grayscale(100%)');
const over=await sample('grayscale(200%)');
const negative=CSS.supports('filter','grayscale(-1)');
console.log('half='+half+'; full='+full+'; over='+over+'; negative='+negative);

Resultado

half=155,27,27; full=54,54,54; over=54,54,54; negative=false

`grayscale()` mistura os componentes de uma imagem na direção da luminância e controla quanta saturação é removida.

Fontes