WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

mask-size — Größe von Maskenbildern

Die Eigenschaft mask-size legt die Abmessungen von Bildern in Maskenebenen fest, nicht die des Elements selbst. Sie akzeptiert Längen, Prozentwerte, auto, contain und cover; für mehrere Ebenen lassen sich unterschiedliche Größen angeben.

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

Syntax

mask-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain;

mask-size skaliert Bilder, die über mask-image bereitgestellt werden, ohne die Layoutabmessungen des Elements zu ändern. Der Anfangswert ist auto; die Eigenschaft wird nicht vererbt. Sie erstellt nicht selbst eine Maske.

Ein Längen- oder Prozentwert legt die Breite fest; die Höhe ist dann standardmäßig auto. Zwei Werte geben jeweils Breite und Höhe an. Negative Werte sind ungültig. Prozentwerte beziehen sich auf die entsprechenden Abmessungen des Maskenpositionierungsbereichs, der durch mask-origin bestimmt wird, nicht auf die Abmessungen der Bilddatei.

auto verwendet, sofern vorhanden, die natürlichen Abmessungen und das Seitenverhältnis des Bildes. Ein Verlauf ohne natürliche Abmessungen füllt mit auto auto den Positionierungsbereich aus. contain erhält das Seitenverhältnis und passt das ganze Bild in diesen Bereich ein; cover erhält das Seitenverhältnis und deckt den gesamten Bereich ab, sodass ein Teil des Bildes darüber hinausragen kann. Zwei ausdrücklich angegebene Abmessungen können das Seitenverhältnis verzerren.

Größen für mehrere Ebenen werden durch Kommas getrennt und entsprechend der Reihenfolge von mask-image angegeben. Eine zu kurze Liste wird wiederholt; überschüssige Werte werden ignoriert. mask-repeat steuert unabhängig davon die Wiederholung des Bildes. Wichtige Ausnahme: Ist die Quelle ein SVG-mask-Element, wirkt mask-size nicht auf diese Ebene; ihre Geometrie wird durch dieses Element festgelegt.

Beispiele

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

Ergebnis

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.

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