CSSPrimitiveValue: setFloatValue() Methode
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.
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 der CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Float-Wert festzulegen. Wenn die Eigenschaft, die diesem Wert zugeordnet ist, die angegebene Einheit oder den Float-Wert nicht akzeptieren kann, bleibt der Wert unverändert und ein DOMException wird ausgelöst.
Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS Object Model zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren ihn nicht.
Um Ihr Ziel zu erreichen, können Sie verwenden:
- das untypisierte CSS Object Model, weit verbreitet unterstützt, oder
- die moderne CSS Typed Object Model API, weniger unterstützt und als experimentell betrachtet.
Syntax
setFloatValue(unitType, floatValue)
Parameter
unitType-
Ein
unsigned short, der den Code für den Einheitentyp darstellt, in dem der Wert zurückgegeben werden soll. Gültige Werte sind:Konstante Beschreibung CSS_CMDer Wert ist ein <length>in Zentimetern.CSS_DEGDer Wert ist ein <angle>in Grad.CSS_DIMENSIONDer Wert ist ein <number>mit einer unbekannten Dimension.CSS_EMSDer Wert ist ein <length>in EM-Einheiten.CSS_EXSDer Wert ist ein <length>in EX-Einheiten.CSS_GRADDer Wert ist ein <angle>in Gradianten.CSS_HZDer Wert ist ein <frequency>in Hertz. Der Wert kann mithilfe der getFloatValue-Methode erhalten werden.CSS_INDer Wert ist ein <length>in Zoll.CSS_KHZDer Wert ist ein <frequency>in Kilohertz.CSS_MMDer Wert ist ein <length>in Millimetern.CSS_MSDer Wert ist eine <time>in Millisekunden.CSS_NUMBERDer Wert ist eine einfache <number>.CSS_PCDer Wert ist ein <length>in Picas.CSS_PERCENTAGEDer Wert ist ein <percentage>.CSS_PTDer Wert ist ein <length>in Punkten.CSS_PXDer Wert ist ein <length>in Pixeln.CSS_RADDer Wert ist ein <angle>in Radianten.CSS_SDer Wert ist eine <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 umgewandelt 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, ist jedoch seitdem aus jeglichen Standardisierungsbemühungen herausgefallen.
Sie wurde durch eine moderne, aber inkompatible CSS Typed Object Model API ersetzt, die sich nun im Standardisierungsprozess befindet.