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

CKTIS / CSS

Propriété CSS `mask-clip`

`mask-clip` limite la zone de peinture de chaque masque-image à une boîte géométrique choisie, ou supprime cette limite avec `no-clip`.

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

Syntaxe

[ <coord-box> | no-clip ]#

mask-clip limite la zone de peinture de chaque masque-image à une boîte géométrique choisie, ou supprime cette limite avec no-clip.

L’exemple applique un masque opaque à deux rectangles SVG avec contour : fill-box donne une alpha de 0 dans la zone du seul contour et 255 dans le remplissage, tandis que stroke-box conserve aussi le point du contour à 255.

Grammaire: [ <coord-box> | no-clip ]#.

Les boîtes CSS proposent content-box, padding-box et border-box ; en SVG, fill-box, stroke-box et view-box visent les limites correspondantes. mask-clip ne contrôle pas une référence vers un élément SVG <mask> : les attributs de ce masque fixent sa zone. La valeur est une liste par couche, vaut initialement border-box, et no-clip ne limite pas la peinture.

Exemples

<!doctype html><meta charset="utf-8"><svg id="stage" xmlns="http://www.w3.org/2000/svg" width="110" height="50"><rect id="fill" x="10" y="10" width="30" height="30" fill="blue" stroke="blue" stroke-width="10" style="mask-image:linear-gradient(black,black);mask-clip:fill-box"/><rect id="stroke" x="70" y="10" width="30" height="30" fill="blue" stroke="blue" stroke-width="10" style="mask-image:linear-gradient(black,black);mask-clip:stroke-box"/></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),fillStroke=alpha(context,6,25),fillCenter=alpha(context,20,25),strokeStroke=alpha(context,66,25),a=getComputedStyle(fill).maskClip,b=getComputedStyle(stroke).maskClip;if(fillStroke>5||fillCenter<250||strokeStroke<250||a!=='fill-box'||b!=='stroke-box')throw new Error('mask-clip geometry mismatch');result.textContent='fill-stroke='+fillStroke+'; fill-center='+fillCenter+'; stroke-stroke='+strokeStroke+'; computed='+a+'/'+b})().catch(error=>result.textContent='ERROR:'+error.message);
</script>

Résultat

fill-stroke=0; fill-center=255; stroke-stroke=255; computed=fill-box/stroke-box

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