CSSPrimitiveValue: setFloatValue() Methode
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.
Die setFloatValue()
-Methode der
CSSPrimitiveValue
-Schnittstelle wird verwendet, um einen Float-Wert festzulegen. Wenn die mit diesem Wert verknüpfte Eigenschaft die angegebene Einheit oder den Float-Wert nicht akzeptieren kann, bleibt der Wert unverändert und eine DOMException
wird 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 ungeschriebene 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 der 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 unbekannter 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 getFloatValue-Methode 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 Zeichenfolgenwert nicht in die
angegebene Einheit umgewandelt werden kann.Ein NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn diese Eigenschaft schreibgeschützt ist. |
Spezifikationen
Dieses Feature wurde ursprünglich in der DOM Style Level 2 Spezifikation definiert, wurde aber seitdem aus allen Standardisierungsbemühungen entfernt.
Es wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich nun auf dem standardmäßigen Pfad befindet.
Browser-Kompatibilität
BCD tables only load in the browser