Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

css
grayscale(amount)

Parameter

amount Optional

Anteil des Eingabebilds, der in Graustufen umgewandelt wird. Er wird als <number> oder <percentage> angegeben. Ein Wert von 100% wandelt das Eingabebild vollständig in Graustufen um, während ein Wert von 0% das Eingabebild unverändert lässt. Werte zwischen 0% und 100% skalieren den Effekt linear. Werte über 100% sind zulässig, der Effekt wird jedoch auf 100% begrenzt. Negative Werte sind nicht zulässig. Der für die Interpolation verwendete Anfangswert ist 0. Der Standardwert ist 1.

Formale Syntax

<grayscale()> = 
grayscale( [ <number> | <percentage> ]? )

Beispiele

Beispiele für gültige Werte von grayscale()

css
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: