La propriété mask-position
indique la position initiale pour chaque image de masque utilisée. Cette position est relative à l'origine définie via la propriété mask-origin
.
/* Valeurs avec un mot-clé */ mask-position: top; mask-position: bottom; mask-position: left; mask-position: right; mask-position: center; /* Valeurs en pourcentage */ /* Type <percentage> */ mask-position: 25% 75%; /* Valeurs en longueur */ /* Type <length> */ mask-position: 0px 0px; mask-position: 1cm 2cm; mask-position: 10ch 8em; /* Valeurs multiples */ mask-position: 0px 0px, center; /* Valeurs globales */ mask-position: inherit; mask-position: initial; mask-position: unset;
Syntaxe
Valeurs
<position>
- Une position CSS (type
<position>
) qui représente une position par rapport aux côtés de la boîte de l'élément. Les décalages indiqués peuvent être relatifs ou absolus. On notera que la position obtenue peut être située en dehors de la boîte de l'élément.
Syntaxe formelle
<position>#où
<position> = [ [ left | center | right ] || [ top | center | bottom ] | [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ]? | [ [ left | right ] <length-percentage> ] && [ [ top | bottom ] <length-percentage> ] ]
où
<length-percentage> = <length> | <percentage>
Exemples
CSS
#wrapper { border: 1px solid black; width: 250px; height: 250px; } #masked { width: 250px; height: 250px; background: blue linear-gradient(red, blue); mask-image: url(https://mdn.mozillademos.org/files/12676/star.svg); mask-repeat: no-repeat; mask-position: top right; /* Can be changed in the live sample */ margin-bottom: 10px; }
HTML
<div id="wrapper"> <div id="masked"> </div> </div> <select id="maskPosition"> <option value="top">top</option> <option value="center">center</option> <option value="bottom">bottom</option> <option value="top right" selected>top right</option> <option value="center center">center center</option> <option value="bottom left">bottom left</option> <option value="10px 20px">10px 20px</option> <option value="60% 20%">60% 20%</option> </select>
JavaScript
var maskPosition = document.getElementById("maskPosition"); maskPosition.addEventListener("change", function (evt) { document.getElementById("masked").style.maskPosition = evt.target.value; });
Résultat
Spécifications
Spécification | État | Commentaires |
---|---|---|
CSS Masking Module Level 1 La définition de 'mask-position' dans cette spécification. |
Candidat au statut de recommandation | Définition initiale. |
Valeur initiale | center |
---|---|
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 |
Pourcentages | fait référence à la taille du masque pour la zone de pointure moins la taille du masque pour la taille de l'image (voir background-position ) |
Média | visuel |
Valeur calculée | Deux mots-clés décrivant l'origine et deux représentant les décalages par rapport à cette origine. Chaque valeur est fournie comme une longueur absolue ou comme un pourcentage. |
Type d'animation | repeatable list of simple list of length, percentage, or calc |
Ordre canonique | selon la grammaire |
Compatibilité des navigateurs
Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.
Update compatibility data on GitHub
Ordinateur | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
mask-position | Chrome
Support complet
1
| Edge Support complet 18 | Firefox
Support complet
53
| IE Aucun support Non | Opera
Support complet
15
| Safari
Support complet
3.2
| WebView Android
Support complet
2
| Chrome Android
Support complet
18
| Firefox Android
Support complet
53
| Opera Android
Support complet
14
| Safari iOS
Support complet
3.2
| Samsung Internet Android
Support complet
Oui
|
Support for three-value syntax of position | Chrome
Aucun support
1 — 68
| Edge Support complet 18 | Firefox
Aucun support
53 — 70
| IE Aucun support Non | Opera
Aucun support
15 — 55
| Safari
Support complet
3.2
| WebView Android
Aucun support
2 — 68
| Chrome Android
Aucun support
18 — 68
| Firefox Android
Support complet
53
| Opera Android
Aucun support
14 — 48
| Safari iOS
Support complet
3.2
| Samsung Internet Android
Support complet
Oui
|
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- 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.
- Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
- Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
- Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.
- Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.