CSSStyleValue: toString() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die toString() Methode der CSSStyleValue Schnittstelle ist ein stringifier, der den Wert als Zeichenkette im Standard-CSS-Textformat zurückgibt.
Syntax
js
toString()
Parameter
Keine.
Rückgabewert
Eine Zeichenkette.
Beschreibung
Die genaue Serialisierung des Objekts zu einer Zeichenkette hängt davon ab, wie das CSSStyleValue-Objekt erhalten wurde:
- Wenn das Objekt durch das Parsen einer CSS-Zeichenkette erstellt wurde, wie z.B. mit
CSSStyleValue.parse(), gibt die Methode die ursprünglich geparste Zeichenkette zurück. - Wenn das Objekt direkt erstellt wurde, etwa mit einer
CSSFabrik-Funktion oder einem Unterklassenkonstruktor, wird die zurückgegebene Zeichenkette gemäß den Serialisierungsregeln dieser Unterklasse generiert. - Wenn das Objekt aus dem CSSOM gelesen wurde, z.B. mit
Element.computedStyleMap()oderHTMLElement.attributeStyleMap, folgt die zurückgegebene Zeichenkette den CSSOM-Serialisierungsregeln.
Weitere Informationen zu den Serialisierungsregeln finden Sie unter Wann und wie Werte serialisiert werden in CSS value serialization.
Beispiele
Grundlegende Verwendung
js
// Parsed from a string: returns the original string
const length1 = CSSStyleValue.parse("42.0px");
length1.toString(); // "42.0px"
// Constructed directly with a CSS factory function: subclass-specific serialization
const length2 = CSS.px(42.0);
length2.toString(); // "42px"
// Read from the CSSOM: follows CSSOM serialization rules
const element = document.createElement("div");
element.style.width = "42.0px";
const length3 = element.attributeStyleMap.get("width");
length3.toString(); // "42px"
Spezifikationen
| Spezifikation |
|---|
| CSS Typed OM Level 1 # stylevalue-serialization |