CKTIS / CSS
mask-size — rozmiar obrazu maski
Właściwość mask-size ustala rozmiar obrazów warstw maski, a nie rozmiar elementu. Obsługuje długości, procenty, auto, contain i cover oraz osobne rozmiary dla wielu warstw.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;mask-size skaluje obrazy wskazane przez mask-image, nie zmieniając wymiarów elementu w układzie strony. Wartość początkowa to auto; właściwość nie jest dziedziczona. Sama nie tworzy maski.
Jedna długość lub wartość procentowa określa szerokość, a wysokość przyjmuje auto; dwie wartości określają kolejno szerokość i wysokość. Wartości ujemne są niedozwolone. Procenty odnoszą się do odpowiednich wymiarów obszaru pozycjonowania maski, wyznaczanego przez mask-origin, nie do rozmiaru pliku obrazu.
auto wykorzystuje naturalne wymiary i proporcje obrazu, jeśli są dostępne. Gradient bez naturalnych wymiarów przy auto auto wypełnia obszar pozycjonowania. contain zachowuje proporcje i mieści cały obraz w tym obszarze; cover zachowuje proporcje i pokrywa cały obszar, więc część obrazu może wychodzić poza niego. Dwie jawne wartości mogą zniekształcić proporcje.
Rozmiary wielu warstw rozdziela się przecinkami, zgodnie z kolejnością mask-image. Zbyt krótka lista jest powtarzana, a nadmiarowe wartości są pomijane. mask-repeat osobno steruje powtarzaniem obrazu. Ważny wyjątek: gdy źródłem jest element SVG mask, mask-size nie ma wpływu na tę warstwę; jej geometrię określa ten element.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>mask-size</title>
<style>
body { margin: 20px; background: white; }
.sample {
width: 240px;
height: 120px;
background: #0066cc;
mask-image: linear-gradient(black, black);
mask-mode: alpha;
mask-origin: border-box;
mask-size: 50% 100%;
mask-position: center;
mask-repeat: no-repeat;
}
</style>
<div class="sample"></div>Wynik
A 120 × 120 CSS-pixel blue square is visible, centered horizontally within a 240 × 120 CSS-pixel element; the remaining area shows the white page background.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.