Stil filterEigenschaft

Style 对象参考手册Style-Objekt

Beispiele

Ändern Sie die Bildfarbe in Schwarzweiß (100% Graustufen):

// Chrome-, Safari- und Opera-Browser
document.getElementById("myImg").style.WebkitFilter = "grayscale(100%)";

// Standardsyntax (wird von anderen großen Browsern nicht unterstützt)
document.getElementById("myImg").style.filter = "grayscale(100%)";

Ausprobieren »

Definition und Verwendung

Die filter-Eigenschaft wird verwendet, um die visuellen Effekte eines Elements (normalerweise <img>) zu definieren.

Hinweis:Wenn das Element kein flexibles Element ist, hat die flexGrow-Eigenschaft keine Wirkung.


Browser-Unterstützung

Die Zahlen in der Tabelle geben die erste Browserversion an, die die Eigenschaft vollständig unterstützt.

Eigenschaft
filter 18.0 Webkit Nicht unterstützt Nicht unterstützt 6.0 Webkit 15.0 Webkit

Hinweis:Chrome, Safari und Opera verwenden stattdessen die WebkitFilter-Eigenschaft.


Syntax

Die filter-Eigenschaft zurückgeben:

object.style.filter

Die filter-Eigenschaft setzen:

object.style.filter="none | blur() | brightness() | contrast() | drop-shadow() | grayscale() | hue-rotate() | invert() | opacity() | saturate() | sepia()"

Filterfunktionen

Hinweis:Filter verwenden normalerweise Prozentwerte (z. B. 75%), aber Dezimalzahlen können ebenfalls verwendet werden (z. B. 0.75).

Filter Beschreibung
none Standardwert; keine Wirkung.
blur(px) Wendet eine Gaußsche Unschärfe auf das Bild an. Der "radius"-Wert legt die Standardabweichung der Gaußschen Funktion fest, oder wie viele Pixel auf dem Bildschirm miteinander vermischt werden; je größer der Wert, desto verschwommener ist das Bild;

Wenn kein Wert festgelegt ist, wird standardmäßig 0 verwendet; dieser Parameter kann CSS-Längenwerte akzeptieren, aber keine Prozentwerte.
brightness(%) Wendet einen linearen Multiplikator auf das Bild an, wodurch es heller oder dunkler erscheint. Wenn der Wert 0% ist, wird das Bild vollständig schwarz. Ein Wert von 100% lässt das Bild unverändert. Andere Werte entsprechen linearen Multiplikatoreffekten. Werte über 100% sind ebenfalls zulässig und machen das Bild heller als zuvor. Wenn kein Wert festgelegt ist, ist der Standardwert 1.
contrast(%) Passt den Kontrast des Bildes an. Ein Wert von 0% macht das Bild vollständig schwarz. Ein Wert von 100% lässt das Bild unverändert. Werte über 100% sind zulässig, was bedeutet, dass ein geringerer Kontrast angewendet wird. Wenn kein Wert festgelegt ist, ist der Standardwert 1.
drop-shadow(h-shadow v-shadow blur spread color)

Wendet einen Schatteneffekt auf das Bild an. Der Schatten wird unter dem Bild zusammengesetzt und kann eine verschwommene, versetzte Version einer Maske sein, die in einer bestimmten Farbe gezeichnet wird. Die Funktion akzeptiert einen Wert vom Typ <shadow> (definiert in CSS3 backgrounds), außer dass das Schlüsselwort "inset" nicht erlaubt ist. Diese Funktion ist der vorhandenen box-shadow-Eigenschaft sehr ähnlich; der Unterschied besteht darin, dass einige Browser durch Filter Hardwarebeschleunigung für bessere Leistung bereitstellen.<shadow>参数如下:

<offset-x> <offset-y> (erforderlich)
Dies sind zwei <length>-Werte, die den Schattenversatz festlegen.<offset-x>Legt den horizontalen Abstand fest. Ein negativer Wert platziert den Schatten links vom Element.<offset-y>Legt den vertikalen Abstand fest. Ein negativer Wert platziert den Schatten oberhalb des Elements. Siehe<length>mögliche Einheiten.
Wenn beide Werte0, erscheint der Schatten direkt hinter dem Element (wenn festgelegt <blur-radius> and/or <spread-radius>,there will be a blur effect.).
<blur-radius> (optional)
Dies ist der dritte <length>-Wert. Je größer der Wert, desto unschärfer wird der Schatten, und der Schatten wird größer und heller. Negative Werte sind nicht erlaubt. Wenn er nicht gesetzt ist, ist der Standardwert 0 (die Schattenkante ist sehr scharf).
<spread-radius> (optional)
Dies ist der vierte <length>-Wert. Positive Werte erweitern und vergrößern den Schatten, negative Werte verkleinern den Schatten. Wenn er nicht gesetzt ist, ist der Standardwert 0 (der Schatten hat dieselbe Größe wie das Element).
Hinweis: WebKit und einige andere Browser unterstützen den vierten Längenwert nicht; wenn er hinzugefügt wird, wird er nicht gerendert.
 
<color> (optional)
Siehe <color> für mögliche Schlüsselwörter und Notationen für diesen Wert. Wenn er nicht gesetzt ist, hängt der Farbwert vom Browser ab. In Gecko (Firefox), Presto (Opera) und Trident (Internet Explorer) wird der colorcolor-Eigenschaftswert verwendet. Außerdem ist der Schatten in WebKit transparent, wenn der Farbwert weggelassen wird.
grayscale(%)

Wandelt das Bild in Graustufen um. Der Wert definiert den Anteil der Umwandlung. Ein Wert von 100% wandelt das Bild vollständig in Graustufen um, und ein Wert von 0% lässt das Bild unverändert. Werte zwischen 0% und 100% sind lineare Multiplikatoren des Effekts. Wenn er nicht gesetzt ist, ist der Standardwert 0.

hue-rotate(deg)

Wendet eine Farbtonrotation auf das Bild an. Der Wert "angle" legt den Farbtonwinkel fest, um den das Bild angepasst wird. Ein Wert von 0deg lässt das Bild unverändert. Wenn der Wert nicht gesetzt ist, ist der Standardwert 0deg. Obwohl es keinen Höchstwert gibt, entsprechen Werte über 360deg einer erneuten Umrundung des Farbkreises.

invert(%)

Invertiert das Eingabebild. Der Wert definiert den Anteil der Konvertierung. Ein Wert von 100% invertiert das Bild vollständig. Ein Wert von 0% lässt das Bild unverändert. Werte zwischen 0% und 100% sind lineare Multiplikatoren des Effekts. Wenn der Wert nicht gesetzt ist, ist der Standardwert 0.

opacity(%)

Konvertiert die Transparenz des Bildes. Der Wert definiert den Anteil der Konvertierung. Ein Wert von 0% ist vollständig transparent, und ein Wert von 100% lässt das Bild unverändert. Werte zwischen 0% und 100% sind lineare Multiplikatoren des Effekts, äquivalent zur Multiplikation der Bild-Samples mit dem Betrag. Wenn der Wert nicht festgelegt ist, ist der Standardwert 1. Diese Funktion ist der vorhandenen opacity-Eigenschaft sehr ähnlich; der Unterschied besteht darin, dass über filter einige Browser Hardwarebeschleunigung bereitstellen, um die Leistung zu verbessern.

saturate(%)

Konvertiert die Sättigung des Bildes. Der Wert definiert den Anteil der Konvertierung. Ein Wert von 0% ist vollständig ungesättigt, und ein Wert von 100% lässt das Bild unverändert. Andere Werte sind lineare Multiplikatoren des Effekts. Werte über 100% sind zulässig und bieten eine höhere Sättigung. Wenn der Wert nicht festgelegt ist, ist der Standardwert 1.

sepia(%)

Konvertiert das Bild in Sepia. Der Wert definiert den Anteil der Konvertierung. Ein Wert von 100% ist vollständig Sepia, und ein Wert von 0% lässt das Bild unverändert. Werte zwischen 0% und 100% sind lineare Multiplikatoren des Effekts. Wenn nicht festgelegt, ist der Standardwert 0.

url()

Die URL-Funktion akzeptiert eine XML-Datei, die einen SVG-Filter festlegt, und kann einen Anker enthalten, um ein bestimmtes Filterelement anzugeben.

Zum Beispiel:

filter: url(svg-url#element-id)
initial

Um die Eigenschaft auf ihren Standardwert festzulegen, siehe:CSS-Schlüsselwort initial

inherit Um die Eigenschaft von ihrem übergeordneten Element zu erben, siehe:CSS-Schlüsselwort inherit

Technische Details

CSS-Version CSS3


Ähnliche Artikel

CSS-Referenz:filter-Eigenschaft


Style 对象参考手册Style-Objekt

Andere Erweiterungen