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

CKTIS / CSS

Propriedade CSS `mask-image`

`mask-image` escolhe para cada camada nenhuma imagem, uma imagem CSS como um gradiente ou um URL para uma imagem ou elemento SVG `<mask>`.

Versão: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review

Sintaxe

<mask-reference>#

mask-image escolhe para cada camada nenhuma imagem, uma imagem CSS como um gradiente ou um URL para uma imagem ou elemento SVG <mask>.

O exemplo rasterizado no Chromium compara quatro fontes: um none isolado mantém a amostra com alfa 255, o gradiente produz 255/0 nos dois lados do limite, um URL válido para uma meia máscara SVG também dá 255/0 e uma imagem transparente fornecida por URL dá 0.

Gramática: <mask-reference>#.

O valor inicial é none. Numa lista com várias camadas, none continua a ocupar uma camada de preto transparente e pode afetar a composição. Uma imagem vazia, falha de transferência, referência inexistente ou fonte não suportada também se torna preto transparente em vez de revelar o elemento. As restantes listas mask-* ajustam-se ao número de itens mask-image; um valor diferente de none cria um contexto de empilhamento.

Exemplos

<!doctype html><meta charset="utf-8"><svg id="stage" xmlns="http://www.w3.org/2000/svg" width="150" height="20"><defs><mask id="half" maskUnits="userSpaceOnUse" x="80" y="0" width="30" height="20" mask-type="alpha"><rect x="80" width="15" height="20" fill="white"/></mask></defs><rect id="plain" width="30" height="20" fill="purple" style="mask-image:none"/><rect id="gradient" x="40" width="30" height="20" fill="purple" style="mask-image:linear-gradient(to right,black 0 50%,transparent 50%)"/><rect id="linked" x="80" width="30" height="20" fill="purple" style="mask-image:url(#half);mask-mode:alpha"/><rect id="missing" x="120" width="30" height="20" fill="purple" style="mask-image:url(data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%221%22%20height%3D%221%22%2F%3E)"/></svg><pre id="result"></pre><script>

const rasterize=svg=>new Promise((resolve,reject)=>{const image=new Image();image.onload=()=>{const canvas=document.createElement('canvas');canvas.width=Number(svg.getAttribute('width'));canvas.height=Number(svg.getAttribute('height'));const context=canvas.getContext('2d');context.drawImage(image,0,0);resolve(context)};image.onerror=()=>reject(new Error('SVG rasterization failed'));image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(new XMLSerializer().serializeToString(svg))});
const alpha=(context,x,y)=>context.getImageData(x,y,1,1).data[3];
(async()=>{const context=await rasterize(stage),none=alpha(context,15,10),gL=alpha(context,45,10),gR=alpha(context,65,10),uL=alpha(context,85,10),uR=alpha(context,105,10),transparent=alpha(context,135,10),computed=getComputedStyle(gradient).maskImage;if(none<250||gL<250||gR>5||uL<250||uR>5||transparent>5||!computed.startsWith('linear-gradient'))throw new Error('mask-image source boundary mismatch '+[none,gL,gR,uL,uR,transparent,computed]);result.textContent='none='+none+'; gradient='+gL+'/'+gR+'; url='+uL+'/'+uR+'; transparent-url='+transparent+'; computed-gradient=true'})().catch(error=>result.textContent='ERROR:'+error.message);
</script>

Resultado

none=255; gradient=255/0; url=255/0; transparent-url=0; computed-gradient=true

O exemplo foi executado localmente numa sessão Chrome isolada e sem rede; o resultado provém da API CSS do navegador.

Fontes