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
das moderne CSS Typed Object Model API, welches 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 kann von der Methode getPropertyCSSValue() des CSSStyleDeclaration Interface 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 etc.), 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 übergeordneten Wert (oder einem anderen Eigenschaftenwert) sind. Es gibt eine Ausnahme für Prozentwerte bei Farben: Da ein Prozentwert bei Farben relativ zum Bereich 0-255 ist, kann ein Farbprozentsatz in eine Zahl umgewandelt werden (siehe auch das Interface RGBColor).

Instanzeigenschaften

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

Instanzmethoden

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. Änderungen an der entsprechenden Stileigenschaft können über das Interface Counter vorgenommen werden.
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 den RGB-Farbwert 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 Interface RGBColor vorgenommen werden.
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. Änderungen an der entsprechenden Stileigenschaft können über das Interface Rect vorgenommen werden.
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 festzulegen. Wenn die Eigenschaft, die mit diesem Wert verknüpft ist, die angegebene 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 festzulegen. Wenn die Eigenschaft, die mit diesem Wert verknüpft 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

Learn how to contribute 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