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.

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

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

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.

Compatibilité des navigateurs

Update compatibility data on GitHub

	Ordinateur						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Webview Android	Chrome pour Android	Edge Mobile	Firefox pour Android	Opera pour Android	Safari sur iOS	Samsung Internet
Support simple Expérimentale	Chrome Support complet 1 Préfixée Support complet 1 Préfixée Préfixée Nécessite l'utilisation d'un préfixe : -webkit-	Edge Support complet 18	Firefox Support complet 53	IE ?	Opera ?	Safari Support complet 4 Préfixée Support complet 4 Préfixée Préfixée Nécessite l'utilisation d'un préfixe : -webkit-	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android Support complet 53	Opera Android ?	Safari iOS ?	Samsung Internet Android ?

Légende

Support complet: Support complet
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.
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.