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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
mask-mode
alpha
luminance
match-source

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch