WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

mask-repeat — Maskenbilder wiederholen

Die Eigenschaft mask-repeat legt fest, ob und wie ein Maskenbild horizontal und vertikal wiederholt wird. Damit lässt sich eine einzelne Maske anzeigen, ein regelmäßiges Kachelmuster erzeugen oder der Abstand beziehungsweise die Größe der Kacheln anpassen.

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

Syntax

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

mask-repeat steuert die Wiederholung von Maskenbildern, nachdem deren Größe und Position festgelegt wurden. Der Anfangswert ist repeat; die Eigenschaft wird nicht vererbt und ihre Animation erfolgt diskret. mask-image legt das Bild fest, mask-size die Kachelgröße und mask-position die Position.

Ein einzelner Wert aus repeat, space, round und no-repeat gilt für beide Achsen. Bei zwei Werten steuert der erste die horizontale und der zweite die vertikale Achse. repeat-x bedeutet repeat no-repeat, repeat-y bedeutet no-repeat repeat. repeat wiederholt die Kacheln, wobei Kacheln am Rand abgeschnitten werden können; no-repeat zeigt auf der jeweiligen Achse eine einzelne Kopie.

space platziert ohne Skalierung so viele vollständige Kacheln wie möglich und verteilt den übrigen Platz zwischen ihnen. Passen mindestens zwei hinein, berühren die äußeren Kacheln die Ränder des Positionierungsbereichs; passt nur eine hinein, ist mask-position maßgeblich. round skaliert die Kacheln so, dass eine ganze Anzahl hineinpasst.

Kommas trennen die Einstellungen für aufeinanderfolgende mask-image-Ebenen; eine zu kurze Liste wird wiederholt. Die Eigenschaft hat keine Wirkung auf eine Ebene, die auf ein SVG-Element mask verweist. Im Beispiel verbirgt die transparente Hälfte jeder Kachel das Element und lässt die weiße Seite durchscheinen.

Beispiele

<!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>

Ergebnis

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.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen