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.

Vollständige Kompatibilität anzeigen
Mehr erfahren

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.

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

Hinweis: Diese Schnittstelle war Teil eines Versuchs, ein typisiertes CSS Object Model zu schaffen. Dieser Ansatz wurde aufgegeben und wird von den meisten Browsern nicht implementiert.

Stattdessen können Sie Folgendes verwenden:

das nicht typisierte CSS Object Model, das weithin unterstützt wird, oder
die moderne CSS Typed Object Model API, die weniger breit unterstützt wird und als experimentell gilt.

Diese Schnittstelle repräsentiert einen einzelnen CSS-Wert. Mit ihr lässt sich der Wert einer bestimmten, aktuell in einem Block festgelegten Style-Eigenschaft ermitteln oder eine bestimmte Style-Eigenschaft innerhalb des Blocks explizit festlegen. Eine Instanz dieser Schnittstelle kann über die Methode getPropertyCSSValue() der Schnittstelle CSSStyleDeclaration abgerufen werden. Ein CSSPrimitiveValue-Objekt kommt nur im Kontext einer CSS-Eigenschaft vor.

Konvertierungen sind zwischen absoluten Werten möglich (etwa von Millimetern in Zentimeter oder von Grad in Radiant), nicht jedoch zwischen relativen Werten. Ein Pixelwert kann beispielsweise nicht in einen Zentimeterwert umgerechnet werden. Prozentwerte können nicht konvertiert werden, da sie sich auf den übergeordneten Wert (oder den Wert einer anderen Eigenschaft) beziehen. Eine Ausnahme bilden Farbprozentwerte: Da sich ein Farbprozentwert auf den Bereich von 0 bis 255 bezieht, kann er in eine Zahl umgewandelt werden (siehe auch die Schnittstelle RGBColor).

Instanzeigenschaften

Erbt Eigenschaften von der übergeordneten Schnittstelle CSSValue.

CSSPrimitiveValue.primitiveType Schreibgeschützt

Ein unsigned short, der den Typ des Werts angibt. Mögliche Werte sind:

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

Instanzmethoden

CSSPrimitiveValue.getCounterValue(): Diese Methode ruft den counter-Wert ab. Enthält dieser CSS-Wert keinen counter-Wert, wird eine DOMException ausgelöst. Die entsprechende Style-Eigenschaft kann über die Schnittstelle Counter geändert werden.
CSSPrimitiveValue.getFloatValue(): Diese Methode ruft einen Gleitkommawert in einer angegebenen Einheit ab. Enthält dieser CSS-Wert keinen Gleitkommawert oder kann er nicht in die angegebene Einheit umgerechnet werden, wird eine DOMException ausgelöst.
CSSPrimitiveValue.getRGBColorValue(): Diese Methode ruft die RGB-Farbe ab. Enthält dieser CSS-Wert keinen RGB-Farbwert, wird eine DOMException ausgelöst. Die entsprechende Style-Eigenschaft kann über die Schnittstelle RGBColor geändert werden.
CSSPrimitiveValue.getRectValue(): Diese Methode ruft den Rect-Wert ab. Enthält dieser CSS-Wert keinen rect-Wert, wird eine DOMException ausgelöst. Die entsprechende Style-Eigenschaft kann über die Schnittstelle Rect geändert werden.
CSSPrimitiveValue.getStringValue(): Diese Methode ruft den String-Wert ab. Enthält der CSS-Wert keinen String-Wert, wird eine DOMException ausgelöst.
CSSPrimitiveValue.setFloatValue(): Diese Methode setzt den Gleitkommawert mit einer angegebenen Einheit. Wenn die mit diesem Wert verknüpfte Eigenschaft die angegebene Einheit oder den Gleitkommawert nicht akzeptiert, bleibt der Wert unverändert und eine DOMException wird ausgelöst.
CSSPrimitiveValue.setStringValue(): Diese Methode setzt den String-Wert mit der angegebenen Einheit. Wenn die mit diesem Wert verknüpfte Eigenschaft die angegebene Einheit oder den String-Wert nicht akzeptiert, 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

Instanzeigenschaften

Instanzmethoden

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN