grayscale()-CSS-Funktion
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.
Die CSS-Funktion grayscale() wandelt das Eingabebild in Graustufen um. Ihr Ergebnis ist eine <filter-function>.
Probieren Sie es aus
filter: grayscale(0);
filter: grayscale(0.2);
filter: grayscale(60%);
filter: grayscale(1);
<section id="default-example">
<img
class="transition-all"
id="example-element"
src="/shared-assets/images/examples/firefox-logo.svg"
width="200" />
</section>
Syntax
grayscale(amount)
Parameter
amountOptional-
Anteil des Eingabebilds, der in Graustufen umgewandelt wird. Er wird als
<number>oder<percentage>angegeben. Ein Wert von100%wandelt das Eingabebild vollständig in Graustufen um, während ein Wert von0%das Eingabebild unverändert lässt. Werte zwischen0%und100%skalieren den Effekt linear. Werte über100%sind zulässig, der Effekt wird jedoch auf100%begrenzt. Negative Werte sind nicht zulässig. Der für die Interpolation verwendete Anfangswert ist0. Der Standardwert ist1.
Formale Syntax
<grayscale()> =
grayscale( [ <number> | <percentage> ]? )
Beispiele
>Beispiele für gültige Werte von grayscale()
grayscale(0) /* No effect */
grayscale(.7) /* 70% grayscale */
grayscale() /* Completely grayscale */
grayscale(1)
grayscale(100%)
Spezifikationen
| Spezifikation |
|---|
| Filter Effects Module Level 1> # funcdef-filter-grayscale> |
Browser-Kompatibilität
Siehe auch
Zu den weiteren <filter-function>-Funktionen, die als Werte der Eigenschaften filter und backdrop-filter verwendet werden können, gehören: