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

CKTIS / CSS

Propriedade CSS `mask`

`mask` reúne numa declaração a imagem, posição, tamanho, repetição, áreas geométricas, modo de interpretação e operador de composição de cada camada.

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

Sintaxe

<mask-layer>#

mask reúne numa declaração a imagem, posição, tamanho, repetição, áreas geométricas, modo de interpretação e operador de composição de cada camada.

O exemplo define primeiro propriedades longas não iniciais e depois substitui-as por uma forma abreviada com gradiente: o raster SVG tem alfa 255 à esquerda e 0 à direita, enquanto os componentes omitidos regressam a match-source, repeat, auto, border-box e add.

Gramática: <mask-layer>#.

As vírgulas criam camadas; numa camada, o tamanho só pode surgir após uma barra que venha depois da posição, e uma única caixa geométrica define origin e clip. Componentes omitidos recebem o valor inicial por camada, listas curtas repetem-se até ao número de imagens e valores excedentes são ignorados. A forma abreviada também repõe mask-border; a máscara altera a pintura, não a geometria nem a deteção.

Exemplos

<!doctype html><meta charset="utf-8"><svg id="stage" xmlns="http://www.w3.org/2000/svg" width="40" height="20"><rect id="box" width="40" height="20" fill="red"/></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()=>{box.style.cssText='mask-mode:luminance;mask-repeat:no-repeat;mask-position:10px 0;mask-size:10px 20px;mask-clip:fill-box;mask-origin:fill-box;mask-composite:exclude';box.style.mask='linear-gradient(to right,black 0 50%,transparent 50%)';const style=getComputedStyle(box),context=await rasterize(stage),left=alpha(context,5,10),right=alpha(context,35,10);if(left<250||right>5||style.maskMode!=='match-source'||style.maskRepeat!=='repeat'||style.maskSize!=='auto'||style.maskClip!=='border-box'||style.maskOrigin!=='border-box'||style.maskComposite!=='add')throw new Error('mask reset/paint mismatch');result.textContent='alpha='+left+'/'+right+'; mode='+style.maskMode+'; repeat='+style.maskRepeat+'; size='+style.maskSize+'; clip='+style.maskClip+'; origin='+style.maskOrigin+'; composite='+style.maskComposite})().catch(error=>result.textContent='ERROR:'+error.message);
</script>

Resultado

alpha=255/0; mode=match-source; repeat=repeat; size=auto; clip=border-box; origin=border-box; composite=add

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

Fontes