mask-position

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

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.
Animable	oui, comme une liste répétable de , une simple liste de , une longueur, pourcentage ou calc() ; quand les deux valeurs sont des longueurs, elles sont interpolées comme des longueurs ; quand les deux valeurs sont des pourcentages, elles sont interpolées comme des pourcentages ; sinon, les deux valeurs sont converties dans une fonction `calc()` qui est la somme d'une longueur et d'un pourcentage (chaque valeur pouvant être à zéro), et cette fonction `calc()` interpole chaque moitié comme un nombre réel.
Ordre canonique	l'ordre unique et non-ambigu défini par la grammaire formelle

Syntaxe

/* 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;

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

Exemples

CSS

.exemple {
  height: 100px;
  width: 100px;
  background-color: rgb(128,128,128);
  border: solid black 1px;
 
  -webkit-mask-image: url('https://developer.mozilla.org/static/img/favicon32.png');
  mask-image: url('https://developer.mozilla.org/static/img/favicon32.png');

  -webkit-mask-position: 20px 20px;
  mask-position: 20px 20px;
}

HTML

<div class="exemple"></div>

Résultat

On voit ici que le motif commence avec un décalage :

Spécifications

Spécification	État	Commentaires
CSS Masking Level 1 La définition de 'mask-position' dans cette spécification.	Candidat au statut de recommandation	Définition initiale.

Fonctionnalité	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Support simple	1.0-webkit	Pas de support^[2]	?	?	4.0-webkit

Fonctionnalité	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Support simple	?	Pas de support^[1]	?	?	?

[1] À l'heure actuelle, Gecko n'implémente pas cette fonctionnalité (cf. bug 1251161).

mask-position

Syntaxe

Valeurs

Syntaxe formelle

Exemples

CSS

HTML

Résultat

Spécifications

Compatibilité des navigateurs

Étiquettes et contributeurs liés au document