CSSPrimitiveValue

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

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:

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 Nur lesbar 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.

Spezifikationen

Diese Funktion wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, wurde jedoch seitdem aus allen Standardisierungsarbeiten entfernt.

Sie wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich jetzt auf dem Standardpfad befindet.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch