Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

mask-repeat — powtarzanie obrazu maski

Właściwość mask-repeat określa, czy i jak obraz maski jest powielany w poziomie i pionie. Pozwala wyświetlić pojedynczą maskę, utworzyć regularne kafelki albo dopasować ich odstępy lub rozmiary.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

mask-repeat: <repeat-style>#;
<repeat-style> = repeat-x | repeat-y | [ repeat | space | round | no-repeat ]{1,2}

mask-repeat steruje powielaniem obrazów maski po ustaleniu ich rozmiaru i położenia. Wartość początkowa to repeat; właściwość nie jest dziedziczona, a jej animacja jest dyskretna. Obraz ustawia mask-image, rozmiar kafelka — mask-size, a położenie — mask-position.

Jedna wartość spośród repeat, space, round i no-repeat dotyczy obu osi. Przy dwóch pierwsza dotyczy poziomu, druga pionu. repeat-x oznacza repeat no-repeat, a repeat-y — no-repeat repeat. repeat powiela kafelki, które mogą zostać przycięte na krawędziach; no-repeat wyświetla jedną kopię w danej osi.

space mieści jak najwięcej pełnych kafelków bez skalowania i rozdziela wolne miejsce między nimi. Gdy mieszczą się co najmniej dwa, skrajne dotykają krawędzi obszaru pozycjonowania; gdy mieści się tylko jeden, znaczenie ma mask-position. round skaluje kafelki tak, aby zmieściła się ich całkowita liczba.

Przecinki oddzielają ustawienia kolejnych warstw mask-image; zbyt krótka lista jest powtarzana. Właściwość nie wpływa na warstwę odwołującą się do elementu SVG mask. W przykładzie przezroczysta połowa kafelka ukrywa element, odsłaniając białą stronę.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>mask-repeat</title>
<style>
  body { background: white; }
  .sample {
    width: 160px;
    height: 80px;
    background: #0066cc;
    mask-image: linear-gradient(to right, black 50%, transparent 50%);
    mask-mode: alpha;
    mask-size: 40px 80px;
    mask-position: 0 0;
    mask-repeat: repeat-x;
  }
</style>
<div class="sample"></div>

Wynik

Four blue vertical stripes, each 20 CSS px wide and 80 CSS px high, separated by 20 CSS px transparent gaps showing the white page.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła