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.