Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
La propriété mask-mode détermine si le masque défini par mask-image est considéré comme un masque de luminance ou un masque alpha (transparence).
/* Valeurs avec un mot-clé */ mask-mode: alpha; mask-mode: luminance; mask-mode: match-source; /* Gestion de plusieurs masques */ mask-mode: alpha, match-source; /* Valeurs globales */ mask-mode: inherit; mask-mode: initial; mask-mode: unset;
| Valeur initiale | match-source |
|---|---|
| Applicabilité | tous les éléments ; en SVG, cela s'applique aux éléments conteneurs à l'exception des éléments defs et des éléments graphiques |
| Héritée | non |
| Média | visuel |
| Valeur calculée | comme spécifié |
| Type d'animation | discrète |
| Ordre canonique | selon la grammaire |
Syntaxe
La propriété mask-mode est définie avec un ou plusieurs mots-clés parmi ceux de la liste suivante, séparés par des virgules.
Valeurs
alpha- Ce mot-clé indique que ce sont les valeurs du canal alpha (le canal de transparence) qui sont utilisées comme valeurs de masque.
luminance- Ce mot-clé indique que ce sont les valeurs de luminance qui sont utilisées comme valeurs de masque.
match-source-
Si la propriété
mask-imageest de type<mask-source>, les valeurs de luminance de l'image doivent être utilisée comme valeurs pour le masque.Si elle est de type
<image>, ce seront les valeurs de transparence (canal alpha) qui seront utilisées.
Syntaxe formelle
<masking-mode>#
Exemples
Alpha
CSS
#masked {
width: 100px;
height: 100px;
background: blue linear-gradient(red, blue);
-webkit-mask-image: url(https://mdn.mozillademos.org/files/12668/MDN.svg);
mask-image: url(https://mdn.mozillademos.org/files/12668/MDN.svg);
-webkit-mask-size: 100% 100%;
mask-size: 100% 100%;
-webkit-mask-mode: alpha;
mask-mode: alpha;
}
HTML
<div id="masked"></div>
Résultat
Luminance
CSS
#masked {
width: 100px;
height: 100px;
background-color: #8cffa0;
-webkit-mask-image: url(https://mdn.mozillademos.org/files/12668/MDN.svg);
mask-image: url(https://mdn.mozillademos.org/files/12668/MDN.svg);
-webkit-mask-size: 100% 100%;
mask-size: 100% 100%;
-webkit-mask-mode: luminance;
mask-mode: luminance;
}
HTML
<div id="masked"></div>
Résultat
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| CSS Masking Module Level 1 La définition de 'mask-mode' dans cette spécification. |
Candidat au statut de recommandation | Définition initiale. |
Compatibilité des navigateurs
| Ordinateur | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Webview Android | Chrome pour Android | Edge Mobile | Firefox pour Android | Opera pour Android | Safari pour iOS | Samsung Internet | |
| Support simple | Chrome Aucun support Non | Edge ? | Firefox Support complet 53 | IE Aucun support Non | Opera Aucun support Non | Safari Aucun support Non | WebView Android Aucun support Non | Chrome Android ? | Edge Mobile ? | Firefox Android Support complet 53 | Opera Android Aucun support Non | Safari iOS Aucun support Non | Samsung Internet Android Aucun support Non |
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- Compatibilité inconnue
- Compatibilité inconnue
- Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
- Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.