CKTIS / CSS
mask-position — positionner une image de masque
La propriété mask-position définit la position de l’image de chaque couche de masque. Elle accepte des mots-clés, des longueurs et des pourcentages ; elle ne déplace pas l’élément lui-même et ne modifie pas sa mise en page.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
mask-position: <position>#;mask-position positionne les images de masque par rapport à la zone définie par mask-origin. Sa valeur initiale est 0% 0% et elle n’est pas héritée. La syntaxe <position># désigne une liste de positions séparées par des virgules, affectées aux couches mask-image successives.
Les valeurs possibles incluent center, left top, 20px 10px et right 20px bottom 10px. Avec deux longueurs, la première indique le décalage horizontal et la seconde le décalage vertical. Une valeur unique comme left laisse l’autre axe centré. Les pourcentages alignent les points correspondants de l’image et de la zone de positionnement : 50% 50% centre l’image. Le décalage sur chaque axe est (taille de la zone - taille de l’image) × pourcentage ; si les tailles sont égales, les pourcentages ne produisent aucun déplacement.
mask-size définit les dimensions de l’image, tandis que mask-repeat contrôle sa répétition. Dans l’exemple, no-repeat permet de voir un seul rectangle de masque. Le masquage modifie la visibilité, pas les dimensions de la boîte de mise en page. Lorsque mask-image fait référence à un élément SVG mask, mask-position n’a aucun effet sur cette couche.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>mask-position</title>
<style>
body { margin: 0; background: white; }
.sample {
width: 200px;
height: 120px;
background: #0066cc;
mask-image: linear-gradient(black, black);
mask-mode: alpha;
mask-origin: border-box;
mask-clip: border-box;
mask-size: 80px 40px;
mask-repeat: no-repeat;
mask-position: right 20px bottom 10px;
}
</style>
<div class="sample"></div>Résultat
Expected visual geometry in CSS pixels: a blue 80 × 40 rectangle with its top-left corner at (100, 70), on a white page. The element retains its 200 × 120 layout box.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.