CKTIS / CSS
Propriété CSS `mask-image`
`mask-image` choisit, pour chaque couche, aucune image, une image CSS comme un dégradé, ou une URL vers une image ou un élément SVG `<mask>`.
Version : CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review
Syntaxe
<mask-reference>#mask-image choisit, pour chaque couche, aucune image, une image CSS comme un dégradé, ou une URL vers une image ou un élément SVG <mask>.
L’exemple rasterisé dans Chromium compare quatre sources : un none seul laisse l’échantillon à une alpha de 255, le dégradé donne 255/0 de part et d’autre de sa limite, une URL valide vers un demi-masque SVG donne aussi 255/0, et une image transparente fournie par URL donne 0.
Grammaire: <mask-reference>#.
La valeur initiale est none. Dans une liste multicouche, none occupe néanmoins une couche noire transparente et peut modifier la composition. Une image vide, un échec de chargement, une référence absente ou une source non prise en charge devient aussi noire transparente au lieu de révéler l’élément. Les autres listes mask-* s’ajustent au nombre d’éléments mask-image ; toute valeur autre que none crée un contexte d’empilement.
Exemples
<!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>Résultat
none=255; gradient=255/0; url=255/0; transparent-url=0; computed-gradient=true
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.