CSSPrimitiveValue

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die CSSPrimitiveValue Schnittstelle leitet sich von der CSSValue Schnittstelle ab und repräsentiert den aktuell berechneten Wert einer CSS-Eigenschaft.

Hinweis: Diese Schnittstelle war Teil eines Versuchs, ein typisiertes CSS-Objektmodell zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren es nicht.

Um Ihr Ziel zu erreichen, können Sie verwenden:

das untypisierte CSS-Objektmodell, das weitgehend unterstützt wird, oder
die moderne CSS Typed Object Model API, die weniger unterstützt und als experimentell gilt.

Diese Schnittstelle repräsentiert einen einzelnen CSS-Wert. Sie kann verwendet werden, um den Wert einer bestimmten Stileigenschaft, die derzeit in einem Block gesetzt ist, zu ermitteln oder um eine bestimmte Stileigenschaft explizit innerhalb des Blocks zu setzen. Eine Instanz dieser Schnittstelle kann über die getPropertyCSSValue() Methode der CSSStyleDeclaration Schnittstelle erhalten werden. Ein CSSPrimitiveValue Objekt tritt nur im Kontext einer CSS-Eigenschaft auf.

Umwandlungen sind zwischen absoluten Werten erlaubt (von Millimetern zu Zentimetern, von Grad zu Radiant usw.), aber nicht zwischen relativen Werten. (Zum Beispiel kann ein Pixelwert nicht in einen Zentimeterwert umgewandelt werden.) Prozentwerte können nicht umgewandelt werden, da sie relativ zum übergeordneten Wert (oder einem anderen Eigenschaftswert) sind. Es gibt eine Ausnahme für Farbprozentwerte: Da ein Farbprozentwert relativ zu dem Bereich 0-255 ist, kann ein Farbprozentwert in eine Zahl umgewandelt werden (siehe auch die RGBColor Schnittstelle).

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, CSSValue.

CSSPrimitiveValue.primitiveType Schreibgeschützt Veraltet

Ein unsigned short, das den Typ des Wertes darstellt. Mögliche Werte sind:

Konstante	Beschreibung
`CSS_ATTR`	Der Wert ist eine `attr()` Funktion. Der Wert kann durch die Verwendung der `getStringValue()` Methode erhalten werden.
`CSS_CM`	Der Wert ist eine `<length>` in Zentimetern. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_COUNTER`	Der Wert ist eine counter oder counters Funktion. Der Wert kann durch die Verwendung der `getCounterValue()` Methode erhalten werden.
`CSS_DEG`	Der Wert ist eine `<angle>` in Grad. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_DIMENSION`	Der Wert ist eine `<number>` mit einer unbekannten Dimension. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_EMS`	Der Wert ist eine `<length>` in em Einheiten. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_EXS`	Der Wert ist eine `<length>` in ex Einheiten. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_GRAD`	Der Wert ist eine `<angle>` in Grads. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_HZ`	Der Wert ist eine `<frequency>` in Hertz. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_IDENT`	Der Wert ist ein Bezeichner. Der Wert kann durch die Verwendung der `getStringValue()` Methode erhalten werden.
`CSS_IN`	Der Wert ist eine `<length>` in Zoll. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_KHZ`	Der Wert ist eine `<frequency>` in Kilohertz. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_MM`	Der Wert ist eine `<length>` in Millimetern. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_MS`	Der Wert ist eine `<time>` in Millisekunden. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_NUMBER`	Der Wert ist eine einfache `<number>`. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_PC`	Der Wert ist eine `<length>` in Picas. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_PERCENTAGE`	Der Wert ist eine `<percentage>`. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_PT`	Der Wert ist eine `<length>` in Punkten. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_PX`	Der Wert ist eine `<length>` in Pixeln. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_RAD`	Der Wert ist eine `<angle>` in Radiant. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_RECT`	Der Wert ist eine `rect()` Funktion. Der Wert kann durch die Verwendung der `getRectValue()` Methode erhalten werden.
`CSS_RGBCOLOR`	Der Wert ist eine `<color>`. Der Wert kann durch die Verwendung der `getRGBColorValue()` Methode erhalten werden.
`CSS_S`	Der Wert ist eine `<time>` in Sekunden. Der Wert kann durch die Verwendung der `getFloatValue()` Methode erhalten werden.
`CSS_STRING`	Der Wert ist eine `<string>`. Der Wert kann durch die Verwendung der `getStringValue()` Methode erhalten werden.
`CSS_UNKNOWN`	Der Wert wird als CSS2-Wert nicht erkannt. Der Wert kann nur durch die Verwendung des `cssText` Attributs erhalten werden.
`CSS_URI`	Der Wert ist eine `<url>`. Der Wert kann durch die Verwendung der `getStringValue()` Methode erhalten werden.

Instanz-Methoden

CSSPrimitiveValue.getCounterValue() Veraltet: Diese Methode wird verwendet, um den counter Wert zu erhalten. Wenn dieser CSS-Wert keinen Zählerwert enthält, wird eine DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können mit der Counter Schnittstelle vorgenommen werden.
CSSPrimitiveValue.getFloatValue() Veraltet: Diese Methode wird verwendet, um einen Float-Wert in einer angegebenen Einheit zu erhalten. Wenn dieser CSS-Wert keinen Float-Wert enthält oder nicht in die angegebene Einheit umgewandelt werden kann, wird eine DOMException ausgelöst.
CSSPrimitiveValue.getRGBColorValue() Veraltet: Diese Methode wird verwendet, um den RGB-Farbwert zu erhalten. Wenn dieser CSS-Wert keinen RGB-Farbwert enthält, wird eine DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können mit der RGBColor Schnittstelle vorgenommen werden.
CSSPrimitiveValue.getRectValue() Veraltet: Diese Methode wird verwendet, um den Rechteckwert zu erhalten. Wenn dieser CSS-Wert keinen Rechteckwert enthält, wird eine DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können mit der Rect Schnittstelle vorgenommen werden.
CSSPrimitiveValue.getStringValue() Veraltet: Diese Methode wird verwendet, um den String-Wert zu erhalten. Wenn der CSS-Wert keinen String-Wert enthält, wird eine DOMException ausgelöst.
CSSPrimitiveValue.setFloatValue() Veraltet: Eine Methode, um den Float-Wert mit einer angegebenen Einheit zu setzen. Wenn die an diesen Wert angehängte Eigenschaft die angegebene Einheit oder den Float-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.
CSSPrimitiveValue.setStringValue() Veraltet: Eine Methode, um den String-Wert mit der angegebenen Einheit zu setzen. Wenn die an diesen Wert angehängte Eigenschaft die angegebene Einheit oder den String-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

CSSPrimitiveValue

Instanz-Eigenschaften

Instanz-Methoden

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN