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.

Das CSSPrimitiveValue-Interface leitet sich vom CSSValue-Interface ab und repräsentiert den aktuell berechneten Wert einer CSS-Eigenschaft.

Hinweis: Dieses Interface 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 Object Model, das weitgehend unterstützt wird, oder
die moderne CSS Typed Object Model API, die weniger unterstützt wird und als experimentell gilt.

Dieses Interface repräsentiert einen einzigen CSS-Wert. Es kann verwendet werden, um den Wert einer bestimmten Stil-Eigenschaft zu bestimmen, die derzeit in einem Block gesetzt ist, oder um eine bestimmte Stil-Eigenschaft explizit innerhalb des Blocks zu setzen. Eine Instanz dieses Interface könnte durch die Methode getPropertyCSSValue() des CSSStyleDeclaration-Interfaces erhalten werden. Ein CSSPrimitiveValue-Objekt tritt nur im Kontext einer CSS-Eigenschaft auf.

Konvertierungen sind zwischen absoluten Werten (von Millimetern zu Zentimetern, von Grad zu Radiant usw.) zulässig, jedoch 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 Elterwert (oder einem anderen Eigenschaftswert) sind. Es gibt eine Ausnahme für Farbprozentsätze: Da ein Farbprozentsatz relativ zum Bereich 0-255 ist, kann ein Farbprozentsatz in eine Zahl umgewandelt werden (siehe auch das RGBColor-Interface).

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, CSSValue.

CSSPrimitiveValue.primitiveType Schreibgeschützt Veraltet

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

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

Instanz-Methoden

CSSPrimitiveValue.getCounterValue() Veraltet: Diese Methode wird verwendet, um den counter-Wert zu erhalten. Wenn dieser CSS-Wert keinen counter-Wert enthält, wird eine DOMException ausgelöst. Die Modifikation der entsprechenden Stil-Eigenschaft kann über das Counter-Interface erfolgen.
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 die RGB-Farbe zu erhalten. Wenn dieser CSS-Wert keinen RGB-Farbwert enthält, wird eine DOMException ausgelöst. Die Modifikation der entsprechenden Stil-Eigenschaft kann über das RGBColor-Interface erfolgen.
CSSPrimitiveValue.getRectValue() Veraltet: Diese Methode wird verwendet, um den Rect-Wert zu erhalten. Wenn dieser CSS-Wert keinen Rect-Wert enthält, wird eine DOMException ausgelöst. Die Modifikation der entsprechenden Stil-Eigenschaft kann über das Rect-Interface erfolgen.
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 damit verbundene Eigenschaft diese 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 damit verbundene Eigenschaft diese Einheit oder den String-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.

CSSPrimitiveValue

Instanz-Eigenschaften

Instanz-Methoden

Spezifikationen

Browser-Kompatibilität

Siehe auch