CSSPrimitiveValue: setStringValue() 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 setStringValue()-Methode der CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Zeichenfolgenwert festzulegen. Wenn die Eigenschaft, die an diesen Wert gebunden ist, die angegebene Einheit oder den Zeichenfolgenwert 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 ihn nicht.

Um Ihr Ziel zu erreichen, können Sie verwenden:

das untypisierte CSS Object Model, das weitgehend unterstützt wird, oder
das moderne CSS Typed Object Model API, das weniger unterstützt und als experimentell angesehen wird.

Syntax

setStringValue(stringType, stringValue)

Parameter

stringType

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

Konstante	Beschreibung
`CSS_ATTR`	Der Wert ist eine `attr()`-Funktion.
`CSS_IDENT`	Der Wert ist ein Identifikator.
`CSS_STRING`	Der Wert ist eine `<string>`.
`CSS_URI`	Der Wert ist ein `<url>`.

stringValue

Eine Zeichenfolge, die den neuen Zeichenfolgenwert darstellt.

Rückgabewert

Keiner (undefined).

Ausnahmen

InvalidAccessError DOMException: Wird ausgelöst, wenn der CSS-Wert keinen Zeichenfolgenwert enthält oder wenn der Zeichenfolgenwert nicht in die angegebene Einheit umgewandelt werden kann.
NoModificationAllowedError' [DOMException`](/de/docs/Web/API/DOMException): 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 seitdem aus jedem Standardisierungsbemühen gestrichen.

Es wurde durch eine moderne, aber inkompatible, CSS Typed Object Model API abgelöst, die sich nun im Standardisierungsprozess befindet.

Browser-Kompatibilität

BCD tables only load in the browser