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.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

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-Objektmodell, das weit unterstützt wird, oder
das moderne CSS Typed Object Model API, das weniger unterstützt und als experimentell angesehen wird.

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

Konvertierungen sind zwischen absoluten Werten erlaubt (von Millimetern zu Zentimetern, von Grad zu Radiant usw.), aber nicht zwischen relativen Werten. (Ein Pixelwert kann beispielsweise nicht in einen Zentimeterwert konvertiert werden.) Prozentwerte können nicht konvertiert werden, da sie relativ zum übergeordneten Wert (oder einem anderen Eigenschaftswert) sind. Eine Ausnahme besteht für Farbprozentwerte: Da ein Farbprozentwert relativ zum Bereich 0-255 ist, kann ein Farbprozentwert in eine Zahl umgewandelt werden (siehe auch das RGBColor Interface).

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, CSSValue.

CSSPrimitiveValue.primitiveType Schreibgeschützt

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 durch die Methode `getStringValue()` erhalten werden.
`CSS_CM`	Der Wert ist eine `<length>` in Zentimetern. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_COUNTER`	Der Wert ist eine counter oder counters Funktion. Der Wert kann durch die Methode `getCounterValue()` erhalten werden.
`CSS_DEG`	Der Wert ist eine `<angle>` in Grad. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_DIMENSION`	Der Wert ist eine `<number>` mit einer unbekannten Dimension. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_EMS`	Der Wert ist eine `<length>` in em-Einheiten. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_EXS`	Der Wert ist eine `<length>` in ex-Einheiten. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_GRAD`	Der Wert ist eine `<angle>` in Grads. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_HZ`	Der Wert ist eine `<frequency>` in Hertz. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_IDENT`	Der Wert ist ein Bezeichner. Der Wert kann durch die Methode `getStringValue()` erhalten werden.
`CSS_IN`	Der Wert ist eine `<length>` in Zoll. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_KHZ`	Der Wert ist eine `<frequency>` in Kilohertz. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_MM`	Der Wert ist eine `<length>` in Millimetern. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_MS`	Der Wert ist eine `<time>` in Millisekunden. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_NUMBER`	Der Wert ist eine einfache `<number>`. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_PC`	Der Wert ist eine `<length>` in Picas. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_PERCENTAGE`	Der Wert ist eine `<percentage>`. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_PT`	Der Wert ist eine `<length>` in Punkten. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_PX`	Der Wert ist eine `<length>` in Pixeln. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_RAD`	Der Wert ist eine `<angle>` in Rad. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_RECT`	Der Wert ist eine `rect()` Funktion. Der Wert kann durch die Methode `getRectValue()` erhalten werden.
`CSS_RGBCOLOR`	Der Wert ist eine `<color>`. Der Wert kann durch die Methode `getRGBColorValue()` erhalten werden.
`CSS_S`	Der Wert ist eine `<time>` in Sekunden. Der Wert kann durch die Methode `getFloatValue()` erhalten werden.
`CSS_STRING`	Der Wert ist eine `<string>`. Der Wert kann durch die Methode `getStringValue()` erhalten werden.
`CSS_UNKNOWN`	Der Wert ist kein erkannter CSS2-Wert. Der Wert kann nur durch das Attribut `cssText` erhalten werden.
`CSS_URI`	Der Wert ist ein `<url>`. Der Wert kann durch die Methode `getStringValue()` erhalten werden.

Instanz-Methoden

CSSPrimitiveValue.getCounterValue(): Diese Methode wird verwendet, um den counter Wert zu erhalten. Falls dieser CSS-Wert keinen Counter-Wert enthält, wird eine DOMException ausgelöst. Eine Modifikation der entsprechenden Stil-Eigenschaft kann mittels des Counter Interfaces erreicht werden.
CSSPrimitiveValue.getFloatValue(): Diese Methode wird verwendet, um einen Float-Wert in einer spezifizierten Einheit zu erhalten. Falls dieser CSS-Wert keinen Float-Wert enthält oder nicht in die spezifizierte Einheit konvertiert werden kann, wird eine DOMException ausgelöst.
CSSPrimitiveValue.getRGBColorValue(): Diese Methode wird verwendet, um den RGB-Farbwert zu erhalten. Falls dieser CSS-Wert keinen RGB-Farbwert enthält, wird eine DOMException ausgelöst. Eine Modifikation der entsprechenden Stil-Eigenschaft kann mittels des RGBColor Interfaces erreicht werden.
CSSPrimitiveValue.getRectValue(): Diese Methode wird verwendet, um den Rect-Wert zu erhalten. Falls dieser CSS-Wert keinen Rect-Wert enthält, wird eine DOMException ausgelöst. Eine Modifikation der entsprechenden Stil-Eigenschaft kann mittels des Rect Interfaces erreicht werden.
CSSPrimitiveValue.getStringValue(): Diese Methode wird verwendet, um den String-Wert zu erhalten. Falls der CSS-Wert keinen String-Wert enthält, wird eine DOMException ausgelöst.
CSSPrimitiveValue.setFloatValue(): Eine Methode, um den Float-Wert mit einer spezifizierten Einheit zu setzen. Falls die mit diesem Wert verknüpfte Eigenschaft die spezifizierte Einheit oder den Float-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.
CSSPrimitiveValue.setStringValue(): Eine Methode, um den String-Wert mit der spezifizierten Einheit zu setzen. Falls die mit diesem Wert verknüpfte Eigenschaft die spezifizierte Einheit oder den String-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.

Help improve MDN

Erfahren Sie, wie Sie beitragen können 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