WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

mask-position — Position eines Maskenbildes

Die Eigenschaft mask-position legt die Position des Bildes jeder Maskenebene fest. Sie unterstützt Schlüsselwörter, Längen und Prozentwerte; sie verschiebt weder das Element selbst noch ändert sie dessen Layout.

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

Syntax

mask-position: <position>#;

mask-position positioniert Maskenbilder relativ zu dem durch mask-origin festgelegten Bereich. Der Anfangswert ist 0% 0%; die Eigenschaft wird nicht vererbt. Die Syntax <position># bezeichnet eine durch Kommas getrennte Liste von Positionen, die den aufeinanderfolgenden mask-image-Ebenen zugewiesen werden.

Mögliche Werte sind center, left top, 20px 10px und right 20px bottom 10px. Bei zwei Längen gibt die erste den horizontalen und die zweite den vertikalen Versatz an. Ein einzelner Wert wie left lässt die andere Achse zentriert. Prozentwerte richten entsprechende Punkte des Bildes und des Positionierungsbereichs aneinander aus: 50% 50% zentriert das Bild. Der Versatz auf jeder Achse beträgt (Größe des Bereichs - Größe des Bildes) × Prozentwert; bei gleichen Größen bewirken Prozentwerte keine Verschiebung.

mask-size legt die Bildabmessungen fest, während mask-repeat die Wiederholung steuert. Im Beispiel sorgt no-repeat dafür, dass ein einzelnes Maskenrechteck sichtbar ist. Maskierung verändert die Sichtbarkeit, nicht die Abmessungen des Layoutfelds. Wenn mask-image auf ein SVG-mask-Element verweist, hat mask-position auf diese Ebene keine Wirkung.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>mask-position</title>
<style>
  body { margin: 0; background: white; }
  .sample {
    width: 200px;
    height: 120px;
    background: #0066cc;
    mask-image: linear-gradient(black, black);
    mask-mode: alpha;
    mask-origin: border-box;
    mask-clip: border-box;
    mask-size: 80px 40px;
    mask-repeat: no-repeat;
    mask-position: right 20px bottom 10px;
  }
</style>
<div class="sample"></div>

Ergebnis

Expected visual geometry in CSS pixels: a blue 80 × 40 rectangle with its top-left corner at (100, 70), on a white page. The element retains its 200 × 120 layout box.

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