Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

Propiedad CSS `mask`

`mask` reúne en una declaración la imagen, posición, tamaño, repetición, áreas geométricas, modo de interpretación y operador de composición de cada capa de máscara.

Versión: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review

Sintaxis

<mask-layer>#

mask reúne en una declaración la imagen, posición, tamaño, repetición, áreas geométricas, modo de interpretación y operador de composición de cada capa de máscara.

El ejemplo establece primero propiedades largas no iniciales y después las sustituye por un atajo con degradado: el ráster SVG tiene alfa 255 a la izquierda y 0 a la derecha, mientras los componentes omitidos vuelven a match-source, repeat, auto, border-box y add.

Gramática: <mask-layer>#.

Las comas crean capas; dentro de una capa, el tamaño solo puede aparecer tras una barra que siga a la posición, y una sola caja geométrica fija origin y clip. Los componentes omitidos toman su valor inicial por capa, las listas cortas se repiten hasta el número de imágenes y los valores sobrantes se ignoran. El atajo también reinicia mask-border; el enmascarado cambia la pintura, no la geometría ni la detección.

Ejemplos

<!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

El ejemplo se ejecutó localmente en una sesión aislada de Chrome sin red; el resultado procede de la API CSS del navegador.

Fuentes