mask-mode

Baseline 2023
Newly available

Since December 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die mask-mode CSS-Eigenschaft legt fest, ob die durch mask-image definierte Maskenreferenz als Luminanz- oder Alphamaske behandelt wird.

Syntax

css
/* Keyword values */
mask-mode: alpha;
mask-mode: luminance;
mask-mode: match-source;

/* Multiple values */
mask-mode: alpha, match-source;

/* Global values */
mask-mode: inherit;
mask-mode: initial;
mask-mode: revert;
mask-mode: revert-layer;
mask-mode: unset;

Die mask-mode-Eigenschaft wird als eines oder mehrere der unten aufgeführten Schlüsselwortwerte, getrennt durch Kommata, angegeben.

Werte

alpha

Dieses Schlüsselwort gibt an, dass die Transparenzwerte (Alphakanal) des Maskenbildebenen verwendet werden sollen.

luminance

Dieses Schlüsselwort gibt an, dass die Luminanzwerte des Maskenbildebenen verwendet werden sollen.

match-source

Wenn die mask-image-Eigenschaft vom Typ <mask-source> ist, sollen die Luminanzwerte des Maskenbildebenen verwendet werden.

Wenn sie vom Typ <image> ist, sollen die Alphawerte des Maskenbildebenen verwendet werden.

Formale Definition

Anfangswertmatch-source
Anwendbar aufalle Elemente; In SVG gilt betrifft dies Containerelemente mit Ausnahme des <defs> Elements und allen Grafikelementen
VererbtNein
Berechneter Wertwie angegeben
Animationstypdiskret

Formale Syntax

mask-mode = 
  <masking-mode>#  

<masking-mode> = 
  alpha         |
  luminance     |
  match-source

Beispiele

Verwendung des Alpha-Maskenmodus

html
<div class="masked"></div>
css
.masked {
  width: 227px;
  height: 200px;
  background: blue linear-gradient(red, blue);

  mask-image: url(https://mdn.github.io/shared-assets/images/examples/mdn.svg);
  mask-mode: alpha;
}

Spezifikationen

Specification
CSS Masking Module Level 1
# the-mask-mode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch