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.

Das CSSPrimitiveValue Interface leitet sich vom CSSValue Interface ab und repräsentiert den aktuellen berechneten Wert einer CSS-Eigenschaft.

Hinweis: Dieses Interface war Teil eines Versuchs, ein getipptes 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 ungetypte CSS-Objektmodell, das weitgehend unterstützt wird, oder
das moderne CSS Typed Object Model API, das 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 durch die 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 Radianten und so weiter), nicht jedoch 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 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 Schreibgeschützt

Ein unsigned short, der den Typ des Wertes repräsentiert. Mögliche Werte sind:

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

Instanz-Methoden

CSSPrimitiveValue.getCounterValue(): Diese Methode wird verwendet, um den counter Wert zu erhalten. Wenn dieser CSS-Wert keinen Counter-Wert enthält, wird ein DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können mit dem Counter Interface erreicht werden.
CSSPrimitiveValue.getFloatValue(): 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 ein 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 ein DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können mit dem 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 ein DOMException ausgelöst. Änderungen an der entsprechenden Stileigenschaft können mit dem 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 ein DOMException ausgelöst.
CSSPrimitiveValue.setFloatValue(): Eine Methode, um den Float-Wert mit einer angegebenen Einheit festzulegen. Wenn die mit diesem Wert verbundene Eigenschaft die angegebene Einheit oder den Float-Wert nicht akzeptieren kann, bleibt der Wert unverändert und ein DOMException wird ausgelöst.
CSSPrimitiveValue.setStringValue(): Eine Methode, um den String-Wert mit der angegebenen Einheit festzulegen. Wenn die mit diesem Wert verbundene Eigenschaft die angegebene Einheit oder den String-Wert nicht akzeptieren kann, bleibt der Wert unverändert und ein 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