CSSPrimitiveValue: setFloatValue()-Methode

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.

Die setFloatValue()-Methode des CSSPrimitiveValue-Interfaces wird verwendet, um einen Float-Wert zu setzen. Wenn die Eigenschaft, die an diesen Wert gebunden ist, die angegebene Einheit oder den Float-Wert nicht akzeptieren kann, bleibt der Wert unverändert und es wird eine DOMException ausgelöst.

Hinweis: Diese Methode 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 nicht typisierte CSS-Objektmodell, das weit verbreitet unterstützt wird, oder
die moderne CSS Typed Object Model API, die weniger unterstützt wird und als experimentell gilt.

Syntax

setFloatValue(unitType, floatValue)

Parameter

unitType

Ein unsigned short, der den Code für den Einheitstyp darstellt, in dem der Wert zurückgegeben werden soll. Gültige Werte sind:

Konstante	Beschreibung
`CSS_CM`	Der Wert ist ein `<length>` in Zentimetern.
`CSS_DEG`	Der Wert ist ein `<angle>` in Grad.
`CSS_DIMENSION`	Der Wert ist ein `<number>` mit einer unbekannten Dimension.
`CSS_EMS`	Der Wert ist ein `<length>` in Em-Einheiten.
`CSS_EXS`	Der Wert ist ein `<length>` in Ex-Einheiten.
`CSS_GRAD`	Der Wert ist ein `<angle>` in Grads.
`CSS_HZ`	Der Wert ist ein `<frequency>` in Hertz. Der Wert kann mit der Methode getFloatValue erhalten werden.
`CSS_IN`	Der Wert ist ein `<length>` in Zoll.
`CSS_KHZ`	Der Wert ist ein `<frequency>` in Kilohertz.
`CSS_MM`	Der Wert ist ein `<length>` in Millimetern.
`CSS_MS`	Der Wert ist ein `<time>` in Millisekunden.
`CSS_NUMBER`	Der Wert ist eine einfache `<number>`.
`CSS_PC`	Der Wert ist ein `<length>` in Picas.
`CSS_PERCENTAGE`	Der Wert ist ein `<percentage>`.
`CSS_PT`	Der Wert ist ein `<length>` in Punkten.
`CSS_PX`	Der Wert ist ein `<length>` in Pixeln.
`CSS_RAD`	Der Wert ist ein `<angle>` in Radiant.
`CSS_S`	Der Wert ist ein `<time>` in Sekunden.

floatValue

Ein float, der den neuen Float-Wert darstellt.

Rückgabewert

Keiner (undefined).

Ausnahmen

Typ	Beschreibung
`DOMException`	Ein `INVALID_ACCESS_ERR` wird ausgelöst, wenn der CSS-Wert keinen Float-Wert enthält oder wenn der String-Wert nicht in die angegebene Einheit konvertiert werden kann. Ein NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn diese Eigenschaft schreibgeschützt ist.

Spezifikationen

Diese Funktion wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, aber seither aus jedem Standardisierungsprozess entfernt.

Sie wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich jetzt auf dem Standardisierungsweg befindet.

Browser-Kompatibilität

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