Propriété filterde Style
Exemples
Changer la couleur de l'image en noir et blanc (100% en niveaux de gris) :
document.getElementById("myImg").style.WebkitFilter = "grayscale(100%)";
// Syntaxe standard (non prise en charge par les autres principaux navigateurs)
document.getElementById("myImg").style.filter = "grayscale(100%)";
Essayez-le »
Définition et utilisation
La propriété filter est utilisée pour définir les effets visuels d'un élément (généralement <img>).
Remarque :Si l'élément n'est pas un élément flexible, la propriété flexGrow n'a aucun effet.
Prise en charge des navigateurs
Les nombres dans le tableau indiquent la première version de navigateur qui prend entièrement en charge la propriété.
| Propriété | |||||
|---|---|---|---|---|---|
| filter | 18.0 Webkit | Non pris en charge | Non pris en charge | 6.0 Webkit | 15.0 Webkit |
Remarque :Chrome, Safari et Opera utilisent la propriété WebkitFilter à la place.
Syntaxe
Retourne la propriété filter :
object.style.filter
Définit la propriété filter :
object.style.filter="none | blur() | brightness() | contrast() | drop-shadow() | grayscale() | hue-rotate() | invert() | opacity() | saturate() | sepia()"
Fonctions de filtre
Remarque :Les filtres utilisent généralement des pourcentages (par exemple, 75%), mais des décimales peuvent également être utilisées (par exemple, 0.75).
| Filter | Description |
|---|---|
| none | Valeur par défaut ; aucun effet. |
| blur(px) | Applique un flou gaussien à l'image. La valeur "radius" définit l'écart type de la fonction gaussienne, ou combien de pixels à l'écran se mélangent, donc plus la valeur est grande, plus l'image est floue ; Si aucune valeur n'est définie, la valeur par défaut est 0 ; ce paramètre peut accepter des valeurs de longueur CSS, mais pas des valeurs en pourcentage. |
| brightness(%) | Applique un multiplicateur linéaire à l'image, la rendant plus claire ou plus sombre. Si la valeur est 0%, l'image sera complètement noire. Une valeur de 100% laisse l'image inchangée. Les autres valeurs correspondent à des effets de multiplicateur linéaire. Les valeurs supérieures à 100% sont également autorisées, rendant l'image plus claire qu'auparavant. Si aucune valeur n'est définie, la valeur par défaut est 1. |
| contrast(%) | Ajuste le contraste de l'image. Une valeur de 0% rend l'image complètement noire. Une valeur de 100% laisse l'image inchangée. Les valeurs supérieures à 100% sont autorisées, ce qui signifie qu'un contraste plus faible sera appliqué. Si aucune valeur n'est définie, la valeur par défaut est 1. |
| drop-shadow(h-shadow v-shadow blur spread color) | Applique un effet d'ombre à l'image. L'ombre est composée sous l'image et peut être une version décalée et floutée d'un masque dessiné dans une couleur spécifique. La fonction accepte une valeur de type <shadow> (défini dans CSS3 backgrounds), sauf que le mot-clé "inset" n'est pas autorisé. Cette fonction est très similaire à la propriété box-shadow existante ; la différence est que, via les filtres, certains navigateurs fournissent une accélération matérielle pour de meilleures performances.
|
| grayscale(%) | Convertit l'image en niveaux de gris. La valeur définit la proportion de la conversion. Une valeur de 100% convertit complètement l'image en niveaux de gris, et une valeur de 0% laisse l'image inchangée. Les valeurs comprises entre 0% et 100% sont des multiplicateurs linéaires de l'effet. Si elle n'est pas définie, la valeur par défaut est 0. |
| hue-rotate(deg) | Applique une rotation de teinte à l'image. La valeur "angle" définit l'angle de teinte selon lequel l'image sera ajustée. Une valeur de 0deg laisse l'image inchangée. Si la valeur n'est pas définie, la valeur par défaut est 0deg. Bien qu'il n'y ait pas de valeur maximale, les valeurs supérieures à 360deg équivalent à refaire un tour de la roue chromatique. |
| invert(%) | Inverse l'image d'entrée. La valeur définit la proportion de la conversion. Une valeur de 100% est complètement inversée. Une valeur de 0% laisse l'image inchangée. Les valeurs entre 0% et 100% sont des multiplicateurs linéaires de l'effet. Si la valeur n'est pas définie, la valeur par défaut est 0. |
| opacity(%) | Convertit la transparence de l'image. La valeur définit la proportion de la conversion. Une valeur de 0 % est complètement transparente, et une valeur de 100 % laisse l'image inchangée. Les valeurs comprises entre 0 % et 100 % sont des multiplicateurs linéaires de l'effet, équivalents à multiplier les échantillons de l'image par la quantité. Si la valeur n'est pas définie, la valeur par défaut est 1. Cette fonction est très similaire à la propriété opacity existante ; la différence est que via filter, certains navigateurs offrent une accélération matérielle pour améliorer les performances. |
| saturate(%) | Convertit la saturation de l'image. La valeur définit la proportion de la conversion. Une valeur de 0 % est complètement désaturée, et une valeur de 100 % laisse l'image inchangée. Les autres valeurs sont des multiplicateurs linéaires de l'effet. Les valeurs supérieures à 100 % sont autorisées, offrant une saturation plus élevée. Si la valeur n'est pas définie, la valeur par défaut est 1. |
| sepia(%) | Convertit l'image en sépia. La valeur définit la proportion de la conversion. Une valeur de 100 % est complètement sépia, et une valeur de 0 % laisse l'image inchangée. Les valeurs comprises entre 0 % et 100 % sont des multiplicateurs linéaires de l'effet. Si elle n'est pas définie, la valeur par défaut est 0. |
| url() | La fonction URL accepte un fichier XML qui définit un filtre SVG, et peut inclure une ancre pour spécifier un élément de filtre spécifique. Par exemple : filter: url(svg-url#element-id) |
| initial | Pour définir la propriété sur sa valeur par défaut, voir :mot-clé initial CSS |
| inherit | Pour hériter de la propriété depuis son élément parent, voir :mot-clé inherit CSS |
Détails techniques
| Version CSS | CSS3 |
|---|
Articles connexes
Référence CSS :propriété filter
Autres extensions
Objet Style