Właściwość mask-clip

Właściwość mask-clip ustawia obszar elementu, w granicach którego będzie wyświetlana maska. Określa, które części elementu zostaną objęte maskowaniem, a które pozostaną widoczne bez zmian.

Składnia

selektor {
	mask-clip: wartość | no-clip;
}

Wartości

Wartość	Opis
`border-box`	Maska jest stosowana do obszaru, włącznie z granicami elementu.
`padding-box`	Maska jest stosowana do obszaru, włącznie z paddingiem, ale bez granic.
`content-box`	Maska jest stosowana tylko do zawartości elementu.
`margin-box`	Maska jest stosowana do obszaru, włącznie z marginesem (eksperymentalne).
`fill-box`	Maska jest stosowana do bounding box obiektu (dla SVG).
`stroke-box`	Maska jest stosowana do stroke bounding box (dla SVG).
`view-box`	Maska jest stosowana do viewbox (dla SVG).
`no-clip`	Maska nie jest ograniczona do obszaru elementu.

Wartość domyślna: border-box.

Przykład . Zastosowanie mask-clip do różnych obszarów

Porównajmy różne wartości mask-clip na elemencie z granicami i wcięciami:

<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;
}

Przykład . Użycie no-clip

Demonstracja wartości no-clip, gdy maska wychodzi poza granice elementu:

<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;
}

Przykład . SVG z różnymi wartościami mask-clip

Zastosowanie różnych wartości do elementu 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>

Zobacz też

właściwość mask-origin,
określa początkową pozycję maski
właściwość mask-image,
ustawia obraz dla maski
właściwość mask,
skrót dla wszystkich właściwości maskowania
właściwość clip-path,
tworzy obszar przycięcia dla elementu