CKTIS / CSS
Propriété CSS `mask`
`mask` regroupe dans une déclaration l’image, la position, la taille, la répétition, les zones géométriques, le mode d’interprétation et l’opérateur de composition de chaque couche.
Version : CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review
Syntaxe
<mask-layer>#mask regroupe dans une déclaration l’image, la position, la taille, la répétition, les zones géométriques, le mode d’interprétation et l’opérateur de composition de chaque couche.
L’exemple fixe d’abord des propriétés détaillées non initiales, puis les remplace par un raccourci à dégradé : le raster SVG a une alpha de 255 à gauche et 0 à droite, tandis que les composants omis reviennent à match-source, repeat, auto, border-box et add.
Grammaire: <mask-layer>#.
Les virgules créent les couches ; dans une couche, la taille ne peut suivre qu’une barre oblique placée après la position, et une seule boîte géométrique règle origin et clip. Les composants omis prennent leur valeur initiale par couche, les listes trop courtes se répètent jusqu’au nombre d’images et les valeurs en trop sont ignorées. Le raccourci réinitialise aussi mask-border ; le masque modifie la peinture, pas la géométrie ni le pointage.
Exemples
<!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>Résultat
alpha=255/0; mode=match-source; repeat=repeat; size=auto; clip=border-box; origin=border-box; composite=add
L’exemple a été exécuté localement dans une session Chrome isolée et sans réseau ; le résultat provient de l’API CSS du navigateur.