From 59499ba3554196f21d379d37d55c2acb27694293 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Sat, 5 Feb 2022 15:42:54 +0100 Subject: Update filter page vs en-US, fix examples, remove xref macros, typofix (#3713) --- files/fr/web/css/filter/index.md | 473 +++++++++++---------- files/fr/web/css/filter/test_form.jpg | Bin 0 -> 12922 bytes files/fr/web/css/filter/test_form_12.jpeg | Bin 0 -> 9483 bytes files/fr/web/css/filter/test_form_12_s.jpg | Bin 0 -> 10504 bytes files/fr/web/css/filter/test_form_14.jpeg | Bin 0 -> 9067 bytes files/fr/web/css/filter/test_form_14_s.jpg | Bin 0 -> 7119 bytes files/fr/web/css/filter/test_form_2.jpeg | Bin 0 -> 7932 bytes files/fr/web/css/filter/test_form_2_s.jpg | Bin 0 -> 3145 bytes files/fr/web/css/filter/test_form_3.jpeg | Bin 0 -> 5319 bytes files/fr/web/css/filter/test_form_3_s.jpg | Bin 0 -> 7580 bytes files/fr/web/css/filter/test_form_4.jpeg | Bin 0 -> 5673 bytes ...est_form_4_irregular-shape_opacity-gradient.png | Bin 0 -> 16541 bytes ...rregular-shape_opacity-gradient_drop-shadow.png | Bin 0 -> 17091 bytes files/fr/web/css/filter/test_form_4_s.jpg | Bin 0 -> 7908 bytes files/fr/web/css/filter/test_form_5.jpeg | Bin 0 -> 8746 bytes files/fr/web/css/filter/test_form_5_s.jpg | Bin 0 -> 9049 bytes files/fr/web/css/filter/test_form_6.jpeg | Bin 0 -> 7194 bytes files/fr/web/css/filter/test_form_6_s.jpg | Bin 0 -> 8209 bytes files/fr/web/css/filter/test_form_7.jpeg | Bin 0 -> 10319 bytes files/fr/web/css/filter/test_form_7_s.jpg | Bin 0 -> 10527 bytes files/fr/web/css/filter/test_form_8.jpeg | Bin 0 -> 4097 bytes files/fr/web/css/filter/test_form_8_s.jpg | Bin 0 -> 5447 bytes files/fr/web/css/filter/test_form_9.jpeg | Bin 0 -> 6717 bytes files/fr/web/css/filter/test_form_9_s.jpg | Bin 0 -> 7195 bytes files/fr/web/css/filter/test_form_s.jpg | Bin 0 -> 5887 bytes 25 files changed, 247 insertions(+), 226 deletions(-) create mode 100644 files/fr/web/css/filter/test_form.jpg create mode 100644 files/fr/web/css/filter/test_form_12.jpeg create mode 100644 files/fr/web/css/filter/test_form_12_s.jpg create mode 100644 files/fr/web/css/filter/test_form_14.jpeg create mode 100644 files/fr/web/css/filter/test_form_14_s.jpg create mode 100644 files/fr/web/css/filter/test_form_2.jpeg create mode 100644 files/fr/web/css/filter/test_form_2_s.jpg create mode 100644 files/fr/web/css/filter/test_form_3.jpeg create mode 100644 files/fr/web/css/filter/test_form_3_s.jpg create mode 100644 files/fr/web/css/filter/test_form_4.jpeg create mode 100644 files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient.png create mode 100644 files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient_drop-shadow.png create mode 100644 files/fr/web/css/filter/test_form_4_s.jpg create mode 100644 files/fr/web/css/filter/test_form_5.jpeg create mode 100644 files/fr/web/css/filter/test_form_5_s.jpg create mode 100644 files/fr/web/css/filter/test_form_6.jpeg create mode 100644 files/fr/web/css/filter/test_form_6_s.jpg create mode 100644 files/fr/web/css/filter/test_form_7.jpeg create mode 100644 files/fr/web/css/filter/test_form_7_s.jpg create mode 100644 files/fr/web/css/filter/test_form_8.jpeg create mode 100644 files/fr/web/css/filter/test_form_8_s.jpg create mode 100644 files/fr/web/css/filter/test_form_9.jpeg create mode 100644 files/fr/web/css/filter/test_form_9_s.jpg create mode 100644 files/fr/web/css/filter/test_form_s.jpg (limited to 'files/fr') diff --git a/files/fr/web/css/filter/index.md b/files/fr/web/css/filter/index.md index 004eb1fd9c..731ace7c00 100644 --- a/files/fr/web/css/filter/index.md +++ b/files/fr/web/css/filter/index.md @@ -1,17 +1,14 @@ --- title: filter slug: Web/CSS/filter -tags: - - CSS - - Propriété - - Reference +browser-compat: css.properties.filter translation_of: Web/CSS/filter --- {{CSSRef}}{{SeeCompatTable}} -La propriété **`filter`** permet d'appliquer des filtres et d'obtenir des effets graphiques de flou, de saturation, etc. Les filtres sont généralement utilisés pour ajuster le rendu d'une image, d'un arrière-plan ou des bordures. +La propriété CSS **`filter`** permet d'appliquer des filtres et d'obtenir des effets graphiques de flou, de saturation, etc. Les filtres sont généralement utilisés pour ajuster le rendu d'une image, d'un arrière-plan ou des bordures. -Plusieurs fonctions sont inclues dans le standard CSS et permettent d'obtenir des effets prédéfinis. Il est également possible d'utiliser un filtre SVG via une URL référençant [un élément SVG `filter`](/fr/docs/Web/SVG/Element/filter). +Plusieurs fonctions sont incluses dans le standard CSS et permettent d'obtenir des effets prédéfinis. Il est également possible d'utiliser un filtre SVG via une URL référençant [un élément SVG `filter`](/fr/docs/Web/SVG/Element/filter). {{EmbedInteractiveExample("pages/css/filter.html")}} @@ -42,54 +39,36 @@ filter: none; /* Valeurs globales */ filter: inherit; filter: initial; +filter: revert; filter: unset; ``` -Avec une fonction, on utilisera la forme suivante : - - filter: []* | none - -En utilisant un élément SVG {{SVGElement("filter")}}, on utilisera la forme suivante : - - filter: url(file.svg#filter-element-id) - -### Interpolation - -Si les deux filtres possèdent chacun une liste de même longueur (sans {{cssxref("<url>")}}, chacune des fonctions est interpolée selon ses propres règles. Si les deux listes ont des longueurs différentes, les derniers filtres de la liste la plus longue sont utilisés avec leurs valeurs par défaut afin de compléter la liste la plus courte, ensuite chaque fonction est interpolée selon ses propres règles. Si un filtre vaut `none`, il est remplacé avec la fonction de filtre (avec ses valeurs par défaut) de l'autre liste puis l'ensemble des fonctions est interpolé selon les règles de chacune. Dans les autres cas, on utilise un interpolation discrète. - -### Syntaxe formelle - -{{csssyntax}} - -## Exemples - -Voici un rapide exemple de filtre fonctionnel. Chaque fonction est illustrée en détail par la suite. +Avec une fonction, on utilisera la forme suivante : ```css -.mydiv { filter: grayscale(50%) } - -/* on applique un niveau de gris à 50% */ -/* et un flou dont le rayon vaut 10px */ -img { -  filter: grayscale(0.5) blur(10px); -} +filter: []* | none ``` -Voici un rapide exemple de filtre utilisant une ressource SVG : +En utilisant un élément SVG [](/fr/docs/Web/SVG/Element/filter), on utilisera la forme suivante : ```css -.target { filter: url(#c1); } - -.mydiv { filter: url(commonfilters.xml#large-blur) } +filter: url(file.svg#filter-element-id) ``` -## Fonctions prédéfinies +### Interpolation + +Si les deux filtres possèdent chacun une liste de même longueur (sans [``](/fr/docs/Web/CSS/url()), chacune des fonctions est interpolée selon ses propres règles. Si les deux listes ont des longueurs différentes, les derniers filtres de la liste la plus longue sont utilisés avec leurs valeurs par défaut afin de compléter la liste la plus courte, ensuite chaque fonction est interpolée selon ses propres règles. Si un filtre vaut `none`, il est remplacé avec la fonction de filtre (avec ses valeurs par défaut) de l'autre liste puis l'ensemble des fonctions est interpolé selon les règles de chacune. Dans les autres cas, on utilise une interpolation discrète. + +## Fonctions Pour utiliser la propriété CSS `filter`, on utilisera `none` ou une ou plusieurs des fonctions listées ci-après avec, pour chacune, un argument. Si la valeur est invalide, la fonction renverra `none`. Sauf mention contraire, les fonctions qui acceptent des valeurs exprimées en pourcentages (34%) acceptent également des valeurs décimales (0.34). +Lorsqu'une seule propriété `filter` possède deux fonctions (ou plus), le résultat obtenu sera différent de l'application de deux propriétés `filter` (ou plus) séparées avec chacune une fonction. + + ### `url()` -La fonction `url()` prend comme argument l'emplacement d'un fichier XML qui définit le filtre SVG à appliquer. L'URL peut faire référence à une ancre d'un élément spécifique. +La fonction `url()` prend comme argument l'emplacement d'un [élément SVG <filter> à appliquer](/en-US/docs/Web/SVG/Element/filter). L'URL peut faire référence à une ancre d'un élément spécifique. Cet élément peut être embarqué dans un fichier XML externe. ```css filter: url(resources.svg#c1) @@ -97,33 +76,37 @@ filter: url(resources.svg#c1) ### `blur()` -Cette fonction applique un flou gaussien à l'image d'entrée. La valeur du paramètre correspond au rayon de flou (l'écart-type de la gaussienne) utilisé. Plus la valeur est importante, plus le flou sera prononcé. La valeur par défaut du paramètre est 0. Selon la spécification, le paramètre est une valeur de type {{cssxref("<length>")}} mais la fonction n'accepte pas de valeurs exprimées en pourcentages. +Cette fonction applique un flou gaussien à l'image d'entrée. La valeur du paramètre correspond au rayon de flou (l'écart-type de la gaussienne) utilisé. Plus la valeur est importante, plus le flou sera prononcé. La valeur par défaut du paramètre est 0. Selon la spécification, le paramètre est une valeur de type [``](/fr/docs/Web/CSS/length) mais la fonction n'accepte pas de valeurs exprimées en pourcentages. ```css filter: blur(5px) ``` ```html hidden - +
- - - - + + + + - - - - + + + +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form.jpgTest_Form.jpg
- - - - -
Test_Form_s.jpg +
+ + + + + + +
+
@@ -181,25 +164,25 @@ table.standard-table td { ``` -{{EmbedLiveSample('blur','100%','236px','')}} +{{EmbedLiveSample('','100%','236px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/blur()", "blur()")}} pour plus d'informations. +> **Note :** Voir [`blur()`](/fr/docs/Web/CSS/filter-function/blur()) pour plus d'informations. ### `brightness()` -La fonction permet de modifier la luminosité d'une image grâce à un facteur linéaire. Un argument égal `0%` créera une image totalement noire et une valeur de `100%` conservera l'image d'entrée telle quelle. Il est possible d'utiliser des valeurs supérieures à `100%` afin d'obtenir des images saturées en luminosité. La valeur par défaut pour l'argument est `1`. +La fonction [`brightness()`](/fr/docs/Web/CSS/filter-function/brightness()) permet de modifier la luminosité d'une image grâce à un facteur linéaire. Un argument égal `0%` créera une image totalement noire et une valeur de `100%` conservera l'image d'entrée telle quelle. Il est possible d'utiliser des valeurs supérieures à `100%` afin d'obtenir des images saturées en luminosité. La valeur par défaut pour l'argument est `1`. ```css -filter: brightness(0.5) +filter: brightness(2) ``` ```svg - + - - - + + + @@ -209,17 +192,17 @@ filter: brightness(0.5) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form.jpgTest_Form.jpg
+
@@ -227,9 +210,9 @@ filter: brightness(0.5) -  +
Test_Form_s.jpg
@@ -250,7 +233,6 @@ body { height:auto; -moz-filter:brightness(2); -webkit-filter:brightness(2); - -o-filter:brightness(2); -ms-filter:brightness(2); filter:brightness(2); } table.standard-table { @@ -281,13 +263,13 @@ table.standard-table td { } ``` -{{EmbedLiveSample('brightness','100%','231px','')}} +{{EmbedLiveSample('','100%','231px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/brightness()", "brightness()")}} pour plus d'informations. +> **Note :** Voir [`brightness()`](/fr/docs/Web/CSS/filter-function/brightness()) pour plus d'informations. ### `contrast()` -Cette fonction permet d'ajuster le contraste de l'image d'entrée. Une valeur de `0%` créera une image entièrement grise. Une valeur de `100%` conservera l'image d'entrée telle quelle. Il est possible d'utiliser des valeurs supérieures à 100% pour augmenter le contraste. La valeur par défaut de l'argument est `1`. +La fonction [`contrast()`](/fr/docs/Web/CSS/filter-function/contrast()) permet d'ajuster le contraste de l'image d'entrée. Une valeur de `0%` créera une image entièrement grise. Une valeur de `100%` conservera l'image d'entrée telle quelle. Il est possible d'utiliser des valeurs supérieures à 100% pour augmenter le contraste. La valeur par défaut de l'argument est `1`. ```css filter: contrast(200%) @@ -304,22 +286,21 @@ filter: contrast(200%) ``` - ```html hidden - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_3.jpegTest_Form_3.jpg
+
@@ -327,9 +308,9 @@ filter: contrast(200%) -  +
Test_Form_s.jpg
@@ -350,7 +331,6 @@ body { height:auto; -moz-filter:contrast(200%); -webkit-filter:contrast(200%); - -o-filter:contrast(200%); -ms-filter:contrast(200%); filter:contrast(200%); } table.standard-table { @@ -381,23 +361,24 @@ table.standard-table td { } ``` -{{EmbedLiveSample('contrast','100%','203px','')}} +{{EmbedLiveSample('','100%','203px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/contrast()", "contrast()")}} pour plus d'informations. +> **Note :** Voir [`contrast()`](/fr/docs/Web/CSS/filter-function/contrast()) pour plus d'informations. ### `drop-shadow()` -Cette fonction permet d'appliquer une ombre portée à l'image d'entrée. Une ombre portée est une version décalée, dans une couleur donnée, du canal alpha de l'image qui est affiché sous celle-ci. La fonction peut accepter une valeur de type {{cssxref("<shadow>")}} (définie dans la spécification CSS3 sur les arrière-plans), une exception : le mot-clé `inset` n'est pas autorisée. Cette fonction est semblable à la propriété {{cssxref("box-shadow")}} plus répandue ; seule différence : les navigateurs utilisent parfois l'accélération matérielle pour les filtres ce qui peut permettre d'obtenir de meilleurs performances. Les paramètres de l'argument `` sont les suivants : +La fonction [`drop-shadow()`](/fr/docs/Web/CSS/filter-function/drop-shadow()) permet d'appliquer une ombre portée à l'image d'entrée. Une ombre portée est une version décalée, dans une couleur donnée, du canal alpha de l'image qui est affiché sous celle-ci. La fonction peut accepter une valeur de type [``](/fr/docs/Web/CSS/shadow) (définie dans la spécification CSS3 sur les arrière-plans), une exception : les mots-clés `inset` et `spread` ne sont pas autorisés. Cette fonction est semblable à la propriété [`box-shadow`](/fr/docs/Web/CSS/box-shadow) plus répandue ; seule différence : les navigateurs utilisent parfois l'accélération matérielle pour les filtres ce qui peut permettre d'obtenir de meilleures performances. Les paramètres de l'argument `` sont les suivants : - `` `` (nécessaire) - - : Deux valeurs {{cssxref("<length>")}} qui indiquent le décalage de l'ombre portée. `` définit la distance horizontale : des valeurs négatives décaleront l'ombre à gauche de l'élément. `` définit la distance verticale : des valeurs négatives décaleront l'ombre au-dessus de l'élément. Se référer à la page {{cssxref("<length>")}} pour les différentes unités utilisables. + - : Deux valeurs [``](/fr/docs/Web/CSS/length) qui indiquent le décalage de l'ombre portée. `` définit la distance horizontale : des valeurs négatives décaleront l'ombre à gauche de l'élément. `` définit la distance verticale : des valeurs négatives décaleront l'ombre au-dessus de l'élément. Se référer à la page [``](/fr/docs/Web/CSS/length) pour les différentes unités utilisables. Si les deux valeurs sont nulles, l'ombre sera exactement placée sous l'élément (et pourra servir à générer un effet de flou si `` et/ou `` sont utilisés). - `` (optionnel) - - : Une troisième valeur de type {{cssxref("<length>")}}. Plus la valeur sera grande, plus le flou sera important (l'ombre sera plus grande et moins prononcée). Les valeurs négatives ne sont pas autorisée. La valeur par défaut est `0`, le bord de l'ombre sera droit. + - : Une troisième valeur de type [``](/fr/docs/Web/CSS/length). Plus la valeur sera grande, plus le flou sera important (l'ombre sera plus grande et moins prononcée). Les valeurs négatives ne sont pas autorisées. La valeur par défaut est `0`, le bord de l'ombre sera droit. - `` (optionnel) - - : Un quatrième valeur de type {{cssxref("<length>")}}. Des valeurs positives agrandiront l'ombre et les valeurs négatives réduiront l'ombre. La valeur par défaut est `0` (l'ombre aura la même taille que l'élément). Note: Webkit, and maybe other browsers, do not support this 4th length; it will not render if added. + - : Une quatrième valeur de type [``](/fr/docs/Web/CSS/length). Des valeurs positives agrandiront l'ombre et les valeurs négatives réduiront l'ombre. La valeur par défaut est `0` (l'ombre aura la même taille que l'élément). Note: Webkit, and maybe other browsers, do not support this 4th length; it will not render if added. - `` (optionnel) - - : Voir {{cssxref("<color>")}} pour les mots-clés et notations possibles. Si ce paramètre n'est pas défini, la couleur choisie dépendra du navigateur. Pour Gecko (Firefox), Presto (Opera) et Trident (Internet Explorer), la valeur de la propriété {{cssxref("color")}} est utilisée. Pour WebKit, si la couleur est absente, l'ombre sera transparente (donc inutile). + - : Voir [``](/fr/docs/Web/CSS/color_value) pour les mots-clés et notations possibles. Si ce paramètre n'est pas défini, la couleur choisie dépendra du navigateur. Pour Gecko (Firefox), Presto (Opera) et Trident (Internet Explorer), la valeur de la propriété [`color`](/fr/docs/Web/CSS/color) est utilisée. Pour WebKit, si la couleur est absente, l'ombre sera transparente (donc inutile). + ```css filter: drop-shadow(16px 16px 10px black) @@ -422,48 +403,55 @@ filter: drop-shadow(16px 16px 10px black) - - - - + + + + - - - - + + + + -      -      + + -      +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_4.jpegTest_Form_4.jpg
- - - - - - - - - -
Test_Form_4_s.jpg +
+ + + + + + + + + + + +
+
Test_Form_4 distorded border - Original imageTest_Form_4 distorded border - Live exampletest_form_4 distorted border - Image originaletest_form_4 distorted border - Exemple <i lang=live" id="img12" class="internal default" src="test_form_4_irregular-shape_opacity-gradient.png" style="width: 100%;" />
- - -     -    -    -      -     -    + + + + + + + + + + - + + -
+
Test_Form_4 distorded border drop shadow - Static exampletest_form_4 distorted border drop shadow - Exemple statique
@@ -484,7 +472,6 @@ body { height:auto; -moz-filter: drop-shadow(16px 16px 10px black); -webkit-filter: drop-shadow(16px 16px 10px black); - -o-filter: drop-shadow(16px 16px 10px black); -ms-filter: drop-shadow(16px 16px 10px black); filter: drop-shadow(16px 16px 10px black); } @@ -493,7 +480,6 @@ body { height:auto; -moz-filter: drop-shadow(8px 9px 5px rgba(0,0,0,.8)); -webkit-filter: drop-shadow(8px 9px 5px rgba(0,0,0,.8)); - -o-filter: drop-shadow(8px 9px 5px rgba(0,0,0,.8)); -ms-filter: drop-shadow(8px 9px 5px rgba(0,0,0,.8)); filter: drop-shadow(8px 9px 5px rgba(0,0,0,.8)); } @@ -524,17 +510,18 @@ table.standard-table td { height:auto; } #img3, #img13 { - height:100%; + width:100%; + height:auto; } ``` -{{EmbedLiveSample('drop-shadow','100%','300px','')}} +{{EmbedLiveSample('','100%','400px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/drop-shadow()", "drop-shadow()")}} pour plus d'informations. +> **Note :** Voir [`drop-shadow()`](/fr/docs/Web/CSS/filter-function/drop-shadow()) pour plus d'informations. ### `grayscale()` -L'image d'entrée est convertie en niveau de gris. La valeur de l'argument définit la force de cette conversion. En utilisant une valeur de `100%` sera complètement en niveaux de gris. `0%` conservera l'image telle quelle. La valeur par défaut du paramètre est `0`. +Avec la fonction [`grayscale()`](/fr/docs/Web/CSS/filter-function/grayscale()), l'image d'entrée est convertie en niveau de gris. La valeur de l'argument définit la force de cette conversion. En utilisant une valeur de `100%` sera complètement en niveaux de gris. `0%` conservera l'image telle quelle. La valeur par défaut du paramètre est `0`. ```css filter: grayscale(100%) @@ -544,17 +531,17 @@ filter: grayscale(100%) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_5.jpegTest_Form_5.jpg
+
-  +
Test_Form_5_s.jpg
@@ -585,7 +572,6 @@ body { height:auto; -moz-filter:grayscale(100%); -webkit-filter:grayscale(100%); - -o-filter:grayscale(100%); -ms-filter:grayscale(100%); filter:grayscale(100%); } table.standard-table { @@ -616,13 +602,17 @@ table.standard-table td { } ``` -{{EmbedLiveSample('grayscale','100%','209px','')}} +{{EmbedLiveSample('','100%','209px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/grayscale()", "grayscale()")}} pour plus d'informations. +> **Note :** Voir [`grayscale()`](/fr/docs/Web/CSS/filter-function/grayscale()) pour plus d'informations. ### `hue-rotate()` -Cette fonction applique une rotation de teinte à l'image d'entrée. La valeur de l'angle passé en argument définit le nombre de degrés parcouru sur le cercle des couleurs. Une valeur de `0deg` conservera l'image telle quelle. La valeur par défaut du paramètre est `0deg`. Il n'y a pas de valeur maximale pour l'argument, si une valeur supérieure à `360deg` est utilisée, ce sera la mesure de l'angle correspondante qui sera utilisée. +La fonction [`hue-rotate()`](/fr/docs/Web/CSS/filter-function/hue-rotate()) applique une rotation de teinte à l'image d'entrée. La valeur de l'angle passé en argument définit le nombre de degrés parcouru sur le cercle des couleurs. Une valeur de `0deg` conservera l'image telle quelle. La valeur par défaut du paramètre est `0deg`. Il n'y a pas de valeur maximale pour l'argument, si une valeur supérieure à `360deg` est utilisée, ce sera la mesure de l'angle correspondante qui sera utilisée. + +```css +filter: hue-rotate(90deg) +``` ```css filter: hue-rotate(90deg) @@ -632,24 +622,24 @@ filter: hue-rotate(90deg) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_6.jpegTest_Form_6.jpg
+
-  +
Test_Form_6_s.jpg
@@ -670,7 +660,6 @@ body { height:auto; -moz-filter:hue-rotate(90deg); -webkit-filter:hue-rotate(90deg); - -o-filter:hue-rotate(90deg); -ms-filter:hue-rotate(90deg); filter:hue-rotate(90deg); } table.standard-table { @@ -703,19 +692,19 @@ table.standard-table td { ```html - - - + + + ``` -{{EmbedLiveSample('hue-rotate','100%','221px','')}} +{{EmbedLiveSample('','100%','221px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/hue-rotate()", "hue-rotate()")}} pour plus d'informations. +> **Note :** Voir [`hue-rotate()`](/fr/docs/Web/CSS/filter-function/hue-rotate()) pour plus d'informations. ### `invert()` -Cette fonction permet d'inverser les couleurs de l'image d'entrée. La valeur de l'argument définit la force de cette inversion. Une valeur de `100%` inversera complètement les couleurs (tel un négatif) et une valeur `0%` conservera l'image d'entrée telle quelle. La valeur par défaut de l'argument est `0`. +La fonction [`invert()`](/fr/docs/Web/CSS/filter-function/invert()) permet d'inverser les couleurs de l'image d'entrée. La valeur de l'argument définit la force de cette inversion. Une valeur de `100%` inversera complètement les couleurs (tel un négatif) et une valeur `0%` conservera l'image d'entrée telle quelle. La valeur par défaut de l'argument est `0`. ```css filter: invert(100%) @@ -725,17 +714,17 @@ filter: invert(100%) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_7.jpegTest_Form_7.jpg
+
@@ -743,9 +732,9 @@ filter: invert(100%) - +
Test_Form_7_s.jpg
@@ -766,7 +755,6 @@ body { height:auto; -moz-filter: invert(100%); -webkit-filter: invert(100%); - -o-filter: invert(100%); -ms-filter: invert(100%); filter: invert(100%); } table.standard-table { @@ -797,13 +785,13 @@ table.standard-table td { } ``` -{{EmbedLiveSample('invert','100%','407px','')}} +{{EmbedLiveSample('','100%','407px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/invert()", "invert()")}} pour plus d'informations. +> **Note :** Voir [`invert()`](/fr/docs/Web/CSS/filter-function/invert()) pour plus d'informations. ### `opacity()` -Cette fonction permet de régler l'opacité de l'image d'entrée. La valeur de l'argument indique la force de l'opacité. Ainsi, une valeur de `0%` rendra l'image complètement transparente et une valeur de `100%` conservera l'image telle quelle. Les valeurs intermédiaires appliqueront des effets proportionnels. La valeur par défaut de l'argument est `1`. Cette fonction est proche de la propriété {{cssxref("opacity")}}, toutefois, avec les filtres, certains navigateurs utilisent l'accélération matérielle, ce qui permet d'obtenir de meilleures performances. +La fonction [`opacity()`](/fr/docs/Web/CSS/filter-function/opacity()) permet de régler l'opacité de l'image d'entrée. La valeur de l'argument indique la force de l'opacité. Ainsi, une valeur de `0%` rendra l'image complètement transparente et une valeur de `100%` conservera l'image telle quelle. Les valeurs intermédiaires appliqueront des effets proportionnels. La valeur par défaut de l'argument est `1`. Cette fonction est proche de la propriété [`opacity`](/fr/docs/Web/CSS/opacity), toutefois, avec les filtres, certains navigateurs utilisent l'accélération matérielle, ce qui permet d'obtenir de meilleures performances. ```css filter: opacity(50%) @@ -813,25 +801,25 @@ filter: opacity(50%) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_14.jpegTest_Form_14.jpg
+
- +
Test_Form_14_s.jpg
@@ -852,7 +840,6 @@ body { height:auto; -moz-filter: opacity(50%); -webkit-filter: opacity(50%); - -o-filter: opacity(50%); -ms-filter: opacity(50%); filter: opacity(50%); } table.standard-table { @@ -883,13 +870,14 @@ table.standard-table td { } ``` -{{EmbedLiveSample('opacity','100%','210px','')}} +{{EmbedLiveSample('','100%','210px','','', 'no-codepen')}} + -> **Note :** Voir {{cssxref("filter-function/opacity()", "opacity()")}} pour plus d'informations. +> **Note :** Voir [`opacity()`](/fr/docs/Web/CSS/filter-function/opacity()) pour plus d'informations. ### `saturate()` -L'image d'entrée est saturée. La valeur de l'argument indique la force de la saturation. Une valeur de `0%` fera que l'image sera totalement désaturée et une valeur de `100%` conservera l'image d'entrée telle quelle. Les valeurs intermédiaires auront un effet linéaire. Il est possible d'utiliser des valeurs supérieures à `100%` pour obtenir un effet de sursaturation. La valeur par défaut de l'argument est `1`. +La fonction [`saturate()`](/fr/docs/Web/CSS/filter-function/saturate()) sature l'image d'entrée. La valeur de l'argument indique la force de la saturation. Une valeur de `0%` fera que l'image sera totalement désaturée et une valeur de `100%` conservera l'image d'entrée telle quelle. Les valeurs intermédiaires auront un effet linéaire. Il est possible d'utiliser des valeurs supérieures à `100%` pour obtenir un effet de sursaturation. La valeur par défaut de l'argument est `1`. ```css filter: saturate(200%) @@ -899,24 +887,24 @@ filter: saturate(200%) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_9.jpegTest_Form_9.jpg
+
- +
Test_Form_9_s.jpg
@@ -937,7 +925,6 @@ body { height:auto; -moz-filter: saturate(200%); -webkit-filter: saturate(200%); - -o-filter: saturate(200%); -ms-filter: saturate(200%); filter: saturate(200%); } table.standard-table { @@ -968,13 +955,13 @@ table.standard-table td { } ``` -{{EmbedLiveSample('saturate','100%','332px','')}} +{{EmbedLiveSample('','100%','332px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/saturate()", "saturate()")}} pour plus d'informations. +> **Note :** Voir [`saturate()`](/fr/docs/Web/CSS/filter-function/saturate()) pour plus d'informations. ### `sepia()` -L'image d'entrée est convertie en sépia. La valeur de l'argument définit la proportion de la conversion. Ainsi, si on utilise un argument égal à 100%, le résultat sera entièrement sépia et si on utilise une valeur de `0%`, l'image d'entrée sera inchangée. Les valeurs comprises entre `0%` et `100%` appliquent l'effet de façon linéaire. La valeur par défaut de l'argument est `0`. +La fonction [`sepia()`](/fr/docs/Web/CSS/filter-function/sepia()) convertit l'image d'entrée est convertie en sépia. La valeur de l'argument définit la proportion de la conversion. Ainsi, si on utilise un argument égal à 100%, le résultat sera entièrement sépia et si on utilise une valeur de `0%`, l'image d'entrée sera inchangée. Les valeurs comprises entre `0%` et `100%` appliquent l'effet de façon linéaire. La valeur par défaut de l'argument est `0`. ```css filter: sepia(100%) @@ -984,17 +971,17 @@ filter: sepia(100%) - - - - + + + + - - - + + - +
Original imageLive exampleSVG EquivalentStatic exampleImage originaleExemple liveÉquivalent SVGExemple statique
Test_Form_12.jpegTest_Form_12.jpg
+
- +
Test_Form_12_s.jpg
@@ -1025,7 +1012,6 @@ body { height:auto; -moz-filter: sepia(100%); -webkit-filter: sepia(100%); - -o-filter: sepia(100%); -ms-filter: sepia(100%); filter: sepia(100%); } table.standard-table { @@ -1056,13 +1042,13 @@ table.standard-table td { } ``` -{{EmbedLiveSample('sepia','100%','229px','')}} +{{EmbedLiveSample('','100%','229px','','', 'no-codepen')}} -> **Note :** Voir {{cssxref("filter-function/sepia()", "sepia()")}} pour plus d'informations. +> **Note :** Voir [`sepia()`](/fr/docs/Web/CSS/filter-function/sepia()) pour plus d'informations. ## Enchaîner les fonctions -On peut appliquer autant de fonction que nécessaire pour manipuler le rendu obtenu. Dans l'exemple suivant, on augmente le contraste et la luminosité de l'image : +On peut appliquer autant de fonction que nécessaire pour manipuler le rendu obtenu. Dans l'exemple suivant, on augmente le contraste et la luminosité de l'image : ```css filter: contrast(175%) brightness(103%) @@ -1072,16 +1058,16 @@ filter: contrast(175%) brightness(103%) - - - + + + - - - + + +
Original imageLive exampleStatic exampleImage originaleExemple liveExemple statique
Test_Form_8.jpegTest_Form_8.jpgTest_Form_8_s.jpg
@@ -1102,7 +1088,6 @@ body { height:auto; -moz-filter: contrast(175%) brightness(103%); -webkit-filter: contrast(175%) brightness(103%); - -o-filter: contrast(175%) brightness(103%); -ms-filter: contrast(175%) brightness(103%); filter: contrast(175%) brightness(103%); } @@ -1134,24 +1119,60 @@ table.standard-table td { } ``` -{{EmbedLiveSample('Enchaîner_les_fonctions','100%','209px','')}} - -## Spécifications +{{EmbedLiveSample('','100%','209px','','', 'no-codepen')}} -| Spécification | État | Commentaires | -| ---------------------------------------------------------------------------- | -------------------------------- | -------------------- | -| {{SpecName('Filters 1.0', '#FilterProperty', 'filter')}} | {{Spec2('Filters 1.0')}} | Définition initiale. | +## Définition formelle {{cssinfo}} +## Syntaxe formelle + +{{csssyntax}} + +## Exemples + +### Appliquer des fonctions de filtre + +Voici un exemple d'utilisation des fonctions prédéfinies abordées ci-avant. Voyez les exemples précédents pour chaque fonction séparément. + +```css +.mondiv { + filter: grayscale(50%); +} + +/* Appliquer un niveau de gris à 50% et un flou de rayon 10px */ +/* pour toutes les images */ +img { + filter: grayscale(0.5) blur(10px); +} +``` + +### Appliquer des filtres SVG + +Voici des exemples où on utilise la fonction `url()` pour tirer parti de ressources SVG existantes : + +```css +.target { + filter: url(#c1); +} + +.mydiv { + filter: url(commonfilters.xml#large-blur); +} +``` + +## Spécifications + +{{Specifications}} + ## Compatibilité des navigateurs -{{Compat("css.properties.filter")}} +{{Compat}} ## Voir aussi - [Appliquer des effets SVG sur du contenu HTML](/fr/docs/Applying_SVG_effects_to_HTML_content) -- La propriété {{cssxref("mask")}} +- La propriété [`mask`](/fr/docs/Web/CSS/mask) - [SVG](/fr/docs/Web/SVG) -- [Un article de HTML5 Rocks : _Understanding CSS filters_ (en anglais)](https://www.html5rocks.com/en/tutorials/filters/understanding-css/) +- [Un article de HTML5 Rocks : Understanding CSS filters (en anglais)](https://www.html5rocks.com/en/tutorials/filters/understanding-css/) - [Générateur de filtres CSS](https://cssgenerator.org/filter-css-generator.html) diff --git a/files/fr/web/css/filter/test_form.jpg b/files/fr/web/css/filter/test_form.jpg new file mode 100644 index 0000000000..058841c04a Binary files /dev/null and b/files/fr/web/css/filter/test_form.jpg differ diff --git a/files/fr/web/css/filter/test_form_12.jpeg b/files/fr/web/css/filter/test_form_12.jpeg new file mode 100644 index 0000000000..6089a9ea41 Binary files /dev/null and b/files/fr/web/css/filter/test_form_12.jpeg differ diff --git a/files/fr/web/css/filter/test_form_12_s.jpg b/files/fr/web/css/filter/test_form_12_s.jpg new file mode 100644 index 0000000000..504208fa3e Binary files /dev/null and b/files/fr/web/css/filter/test_form_12_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_14.jpeg b/files/fr/web/css/filter/test_form_14.jpeg new file mode 100644 index 0000000000..e7574e0000 Binary files /dev/null and b/files/fr/web/css/filter/test_form_14.jpeg differ diff --git a/files/fr/web/css/filter/test_form_14_s.jpg b/files/fr/web/css/filter/test_form_14_s.jpg new file mode 100644 index 0000000000..3e56addda4 Binary files /dev/null and b/files/fr/web/css/filter/test_form_14_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_2.jpeg b/files/fr/web/css/filter/test_form_2.jpeg new file mode 100644 index 0000000000..af66658d4d Binary files /dev/null and b/files/fr/web/css/filter/test_form_2.jpeg differ diff --git a/files/fr/web/css/filter/test_form_2_s.jpg b/files/fr/web/css/filter/test_form_2_s.jpg new file mode 100644 index 0000000000..902d6b7bf7 Binary files /dev/null and b/files/fr/web/css/filter/test_form_2_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_3.jpeg b/files/fr/web/css/filter/test_form_3.jpeg new file mode 100644 index 0000000000..812b6e0642 Binary files /dev/null and b/files/fr/web/css/filter/test_form_3.jpeg differ diff --git a/files/fr/web/css/filter/test_form_3_s.jpg b/files/fr/web/css/filter/test_form_3_s.jpg new file mode 100644 index 0000000000..0a47dc453a Binary files /dev/null and b/files/fr/web/css/filter/test_form_3_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_4.jpeg b/files/fr/web/css/filter/test_form_4.jpeg new file mode 100644 index 0000000000..31e0cbf5d4 Binary files /dev/null and b/files/fr/web/css/filter/test_form_4.jpeg differ diff --git a/files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient.png b/files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient.png new file mode 100644 index 0000000000..db985e4bf9 Binary files /dev/null and b/files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient.png differ diff --git a/files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient_drop-shadow.png b/files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient_drop-shadow.png new file mode 100644 index 0000000000..f0940b7138 Binary files /dev/null and b/files/fr/web/css/filter/test_form_4_irregular-shape_opacity-gradient_drop-shadow.png differ diff --git a/files/fr/web/css/filter/test_form_4_s.jpg b/files/fr/web/css/filter/test_form_4_s.jpg new file mode 100644 index 0000000000..c54746d078 Binary files /dev/null and b/files/fr/web/css/filter/test_form_4_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_5.jpeg b/files/fr/web/css/filter/test_form_5.jpeg new file mode 100644 index 0000000000..9b5c708020 Binary files /dev/null and b/files/fr/web/css/filter/test_form_5.jpeg differ diff --git a/files/fr/web/css/filter/test_form_5_s.jpg b/files/fr/web/css/filter/test_form_5_s.jpg new file mode 100644 index 0000000000..6233d62a52 Binary files /dev/null and b/files/fr/web/css/filter/test_form_5_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_6.jpeg b/files/fr/web/css/filter/test_form_6.jpeg new file mode 100644 index 0000000000..c0d910c87b Binary files /dev/null and b/files/fr/web/css/filter/test_form_6.jpeg differ diff --git a/files/fr/web/css/filter/test_form_6_s.jpg b/files/fr/web/css/filter/test_form_6_s.jpg new file mode 100644 index 0000000000..a3ee5ba075 Binary files /dev/null and b/files/fr/web/css/filter/test_form_6_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_7.jpeg b/files/fr/web/css/filter/test_form_7.jpeg new file mode 100644 index 0000000000..5dde3ae6a9 Binary files /dev/null and b/files/fr/web/css/filter/test_form_7.jpeg differ diff --git a/files/fr/web/css/filter/test_form_7_s.jpg b/files/fr/web/css/filter/test_form_7_s.jpg new file mode 100644 index 0000000000..77224ff05c Binary files /dev/null and b/files/fr/web/css/filter/test_form_7_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_8.jpeg b/files/fr/web/css/filter/test_form_8.jpeg new file mode 100644 index 0000000000..499d89b99e Binary files /dev/null and b/files/fr/web/css/filter/test_form_8.jpeg differ diff --git a/files/fr/web/css/filter/test_form_8_s.jpg b/files/fr/web/css/filter/test_form_8_s.jpg new file mode 100644 index 0000000000..98e3146a52 Binary files /dev/null and b/files/fr/web/css/filter/test_form_8_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_9.jpeg b/files/fr/web/css/filter/test_form_9.jpeg new file mode 100644 index 0000000000..5f73c0af10 Binary files /dev/null and b/files/fr/web/css/filter/test_form_9.jpeg differ diff --git a/files/fr/web/css/filter/test_form_9_s.jpg b/files/fr/web/css/filter/test_form_9_s.jpg new file mode 100644 index 0000000000..ae67b7329b Binary files /dev/null and b/files/fr/web/css/filter/test_form_9_s.jpg differ diff --git a/files/fr/web/css/filter/test_form_s.jpg b/files/fr/web/css/filter/test_form_s.jpg new file mode 100644 index 0000000000..361a81b63d Binary files /dev/null and b/files/fr/web/css/filter/test_form_s.jpg differ -- cgit v1.2.3-54-g00ecf