CSSPrimitiveValue: Methode setStringValue()
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 setStringValue()-Methode der CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Zeichenfolgenwert festzulegen. Wenn die Eigenschaft, die mit diesem Wert verbunden ist, die angegebene Einheit oder den Zeichenfolgenwert 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 untypisierte CSS Object Model, das weit verbreitet unterstützt wird, oder
- das moderne CSS Typed Object Model API, weniger unterstützt und als experimentell angesehen.
Syntax
setStringValue(stringType, stringValue)
Parameter
stringType-
Ein
unsigned short, der den Typ des Wertes darstellt. Mögliche Werte sind: stringValue-
Eine Zeichenfolge, die den neuen Zeichenfolgenwert darstellt.
Rückgabewert
Keine (undefined).
Ausnahmen
InvalidAccessErrorDOMException-
Wird ausgelöst, wenn der CSS-Wert keinen Zeichenfolgenwert enthält oder der Zeichenfolgenwert nicht in die angegebene Einheit umgewandelt werden kann.
NoModificationAllowedErrorDOMException-
Wird ausgelöst, wenn die Eigenschaft schreibgeschützt ist.
Spezifikationen
Dieses Feature wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, wurde jedoch seither aus allen Standardisierungsbemühungen gestrichen.
Es wurde durch ein modernes, aber inkompatibles CSS Typed Object Model API ersetzt, das sich nun auf dem Standardpfad befindet.