CSSPrimitiveValue

Deprecated

Avoid using this feature in new projects. The DOM level 2 CSS object model was excluded from the later CSS object model (CSSOM) specification. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: CSS object model.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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 Object Model 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 weit verbreitet 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 einzelnen CSS-Wert. Es kann verwendet werden, um den Wert einer bestimmten Stileigenschaft zu bestimmen, die derzeit in einem Block festgelegt ist, oder um eine bestimmte Stileigenschaft explizit innerhalb des Blocks festzulegen. Eine Instanz dieses Interfaces könnte von der Methode getPropertyCSSValue() des CSSStyleDeclaration-Interfaces 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.), 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 Elternelementwert (oder einem anderen Eigenschaftswert) sind. Es gibt eine Ausnahme 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 repräsentiert. Mögliche Werte sind:

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

Instanz-Methoden

CSSPrimitiveValue.getCounterValue(): Diese Methode wird verwendet, um den Counter-Wert abzurufen. Wenn dieser CSS-Wert keinen Counter-Wert enthält, wird eine DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können über das Counter-Interface erreicht werden.
CSSPrimitiveValue.getFloatValue(): Diese Methode wird verwendet, um einen Gleitkommawert in einer bestimmten Einheit zu erhalten. Wenn dieser CSS-Wert keinen Gleitkommawert enthält oder nicht in die angegebene Einheit umgewandelt werden kann, wird eine DOMException ausgelöst.
CSSPrimitiveValue.getRGBColorValue(): Diese Methode wird verwendet, um die RGB-Farbe zu erhalten. Wenn dieser CSS-Wert keinen RGB-Farbwert enthält, wird eine DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können über das RGBColor-Interface erreicht werden.
CSSPrimitiveValue.getRectValue(): Diese Methode wird verwendet, um den Rect-Wert zu erhalten. Wenn dieser CSS-Wert keinen Rect-Wert enthält, wird eine DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können über das Rect-Interface erreicht werden.
CSSPrimitiveValue.getStringValue(): 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(): Eine Methode, um den Gleitkommawert mit einer bestimmten Einheit festzulegen. Wenn die Eigenschaft, die mit diesem Wert verbunden ist, die angegebene Einheit oder den Gleitkommawert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException wird ausgelöst.
CSSPrimitiveValue.setStringValue(): Eine Methode, um den String-Wert mit der angegebenen Einheit festzulegen. Wenn die Eigenschaft, die mit diesem Wert verbunden ist, die angegebene 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