Propriété CSSEffets

mask-image

Utilise une image ou un dégradé comme masque de transparence d’un élément.

Valeur initiale
none
Héritée
Non
Animable
non
S’applique à
tous les éléments
JavaScript
element.style.maskImage = "linear-gradient(black, transparent)"
Sur cette page

Exemple

#
CSS
.scroller {
  overflow-x: auto;
  mask-image: linear-gradient(to right, black 80%, transparent);
}
Aperçu

Définition et utilisation

#

La propriété mask-image définit un masque : là où le masque est opaque, l’élément est visible, et là où il est transparent, l’élément disparaît. Contrairement à clip-path, un masque peut avoir des transitions progressives.

L’usage le plus courant est un dégradé linéaire qui estompe progressivement l’élément près d’un bord, par exemple la fin d’une liste défilante ou une photo qui se fond dans l’arrière-plan.

Les propriétés mask-size, mask-position et mask-repeat fonctionnent comme leurs équivalents pour l’arrière-plan. Un masque issu d’un fichier SVG ou PNG permet de donner à un élément n’importe quelle forme.

Syntaxe

#
Syntaxe
mask-image: none | url(…) | <dégradé> [, …]*;

Valeurs

#

Valeurs en pratique

#

none

Aucun masque, l’élément est entièrement visible.
.demo { mask-image: none; }

linear-gradient(black, transparent)

L’image disparaît progressivement vers le bas.
.demo { mask-image: linear-gradient(black, transparent); }

radial-gradient(circle, black 40%, transparent 70%)

Un centre visible et des bords estompés.
.demo { mask-image: radial-gradient(circle, black 40%, transparent 70%); }

linear-gradient(to right, black 70%, transparent)

Un bord droit estompé.
.demo { mask-image: linear-gradient(to right, black 70%, transparent); }

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Un bord estompé sur une barre défilante est un indice discret qu’il y a d’autres contenus.
  • Pour les navigateurs plus anciens, ajoutez une version avec le préfixe -webkit-mask-image.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.