Proprietà mask-clip

La proprietà mask-clip imposta l'area dell'elemento all'interno della quale verrà visualizzata la maschera. Determina quali parti dell'elemento saranno interessate dalla mascheratura e quali rimarranno visibili senza modifiche.

Sintassi

selettore {
	mask-clip: valore | no-clip;
}

Valori

Valore	Descrizione
`border-box`	La maschera viene applicata all'area, inclusi i bordi dell'elemento.
`padding-box`	La maschera viene applicata all'area, incluso il padding, ma non i bordi.
`content-box`	La maschera viene applicata solo al contenuto dell'elemento.
`margin-box`	La maschera viene applicata all'area, incluso il margin (sperimentale).
`fill-box`	La maschera viene applicata al bounding box dell'oggetto (per SVG).
`stroke-box`	La maschera viene applicata allo stroke bounding box (per SVG).
`view-box`	La maschera viene applicata alla viewbox (per SVG).
`no-clip`	La maschera non è limitata all'area dell'elemento.

Valore predefinito: border-box.

Esempio . Applicazione di mask-clip a diverse aree

Confrontiamo diversi valori di mask-clip su un elemento con bordi e spaziature:

<div class="box border-box">border-box</div>
<div class="box padding-box">padding-box</div>
<div class="box content-box">content-box</div>

.box {
	width: 200px;
	height: 100px;
	margin: 20px;
	padding: 20px;
	border: 10px dashed black;
	background: linear-gradient(45deg, red, blue);
	mask-image: linear-gradient(to right, black, transparent);
	mask-size: 100% 100%;
	mask-repeat: no-repeat;
	display: inline-block;
}

.border-box {
	mask-clip: border-box;
}

.padding-box {
	mask-clip: padding-box;
}

.content-box {
	mask-clip: content-box;
}

Esempio . Utilizzo di no-clip

Dimostrazione del valore no-clip, quando la maschera supera i limiti dell'elemento:

<div id="elem"></div>

#elem {
	width: 200px;
	height: 200px;
	background: linear-gradient(45deg, red, blue);
	mask-image: radial-gradient(circle, black 50%, transparent 70%);
	mask-size: 300px 300px;
	mask-position: center;
	mask-clip: no-clip;
	border: 2px solid black;
}

Esempio . SVG con diversi valori di mask-clip

Applicazione di diversi valori a un elemento SVG:

<svg width="400" height="200">
	<defs>
		<mask id="mask1" maskContentUnits="objectBoundingBox">
			<rect x="0.1" y="0.1" width="0.8" height="0.8" fill="white"/>
		</mask>
	</defs>
	
	<rect x="10" y="10" width="180" height="180" fill="blue" 
		mask="url(#mask1)" mask-clip="fill-box"/>
		
	<rect x="210" y="10" width="180" height="180" fill="red" 
		mask="url(#mask1)" mask-clip="view-box"/>
</svg>

Vedi anche

proprietà mask-origin,
definisce la posizione di origine della maschera
proprietà mask-image,
imposta l'immagine per la maschera
proprietà mask,
scorciatoia per tutte le proprietà di mascheratura
proprietà clip-path,
crea un'area di ritaglio per l'elemento