Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

Propriété CSS `mask-mode`

`mask-mode` choisit pour chaque couche si les valeurs du masque viennent de l’alpha, de la luminance multipliée par l’alpha, ou du type de source.

Version : CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review

Syntaxe

<masking-mode>#

mask-mode choisit pour chaque couche si les valeurs du masque viennent de l’alpha, de la luminance multipliée par l’alpha, ou du type de source.

L’exemple rasterisé dans Chromium emploie du noir opaque : alpha le garde visible à 255, luminance le masque à 0, et match-source donne 255 pour un dégradé CSS mais 0 pour une URL vers <mask mask-type="luminance">.

Grammaire: <masking-mode>#.

match-source signifie alpha pour une source ordinaire <image>, mais suit le mask-type d’un élément SVG <mask> référencé par URL ; alpha ou luminance explicite remplace ce choix. Un noir totalement opaque est donc un masque plein en mode alpha et nul en mode luminance. La valeur initiale est match-source ; sa liste se répète ou se tronque au nombre de couches mask-image et n’affecte pas mask-border-source.

Exemples

<!doctype html><meta charset="utf-8"><svg id="stage" xmlns="http://www.w3.org/2000/svg" width="150" height="20"><defs><mask id="lum" maskUnits="userSpaceOnUse" x="120" y="0" width="30" height="20" mask-type="luminance"><rect x="120" width="30" height="20" fill="black"/></mask></defs><rect id="alphaBox" width="30" height="20" fill="orange" style="mask-image:linear-gradient(black,black);mask-mode:alpha"/><rect id="luminanceBox" x="40" width="30" height="20" fill="orange" style="mask-image:linear-gradient(black,black);mask-mode:luminance"/><rect id="matchImage" x="80" width="30" height="20" fill="orange" style="mask-image:linear-gradient(black,black);mask-mode:match-source"/><rect id="matchMask" x="120" width="30" height="20" fill="orange" style="mask-image:url(#lum);mask-mode:match-source"/></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),a=alpha(context,15,10),l=alpha(context,55,10),mi=alpha(context,95,10),mm=alpha(context,135,10),modes=[alphaBox,luminanceBox,matchImage,matchMask].map(node=>getComputedStyle(node).maskMode).join('/');if(a<250||l>5||mi<250||mm>5||modes!=='alpha/luminance/match-source/match-source')throw new Error('mask-mode interpretation mismatch');result.textContent='alpha='+a+'; luminance='+l+'; match-image='+mi+'; match-mask='+mm+'; modes='+modes})().catch(error=>result.textContent='ERROR:'+error.message);
</script>

Résultat

alpha=255; luminance=0; match-image=255; match-mask=0; modes=alpha/luminance/match-source/match-source

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.

Sources