Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła