Propriété filterde Style

Style 对象参考手册Objet Style

Exemples

Changer la couleur de l'image en noir et blanc (100% en niveaux de gris) :

// Navigateurs Chrome, Safari et Opera
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.<shadow>参数如下:

<offset-x> <offset-y> (obligatoire)
Ce sont deux valeurs <length> qui définissent le décalage de l'ombre.<offset-x>Définit la distance horizontale. Une valeur négative place l'ombre à gauche de l'élément.<offset-y>Définit la distance verticale. Une valeur négative place l'ombre au-dessus de l'élément. Voir<length>unités possibles.
Si les deux valeurs sont0, l'ombre apparaît directement derrière l'élément (si défini <blur-radius> and/or <spread-radius>,there will be a blur effect.).
<blur-radius> (facultatif)
Il s'agit de la troisième valeur <length>. Plus la valeur est grande, plus l'ombre est floue, et l'ombre deviendra plus grande et plus claire. Les valeurs négatives ne sont pas autorisées. Si elle n'est pas définie, la valeur par défaut est 0 (le bord de l'ombre est très net).
<spread-radius> (facultatif)
Il s'agit de la quatrième valeur <length>. Les valeurs positives agrandiront et élargiront l'ombre, les valeurs négatives réduiront l'ombre. Si elle n'est pas définie, la valeur par défaut est 0 (l'ombre aura la même taille que l'élément).
Remarque : WebKit et certains autres navigateurs ne prennent pas en charge la quatrième longueur ; si elle est ajoutée, elle ne sera pas rendue.
 
<color> (facultatif)
Voir <color> pour les mots-clés et notations possibles pour cette valeur. Si elle n'est pas définie, la valeur de couleur dépend du navigateur. Dans Gecko (Firefox), Presto (Opera) et Trident (Internet Explorer), la couleurcolorvaleur de la propriété. De plus, si la valeur de couleur est omise, l'ombre est transparente dans WebKit.
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


Style 对象参考手册Objet Style

Autres extensions