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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die toString()-Methode der CSSStyleValue-Schnittstelle ist ein Stringifier, der den Wert formatiert als Zeichenkette von standardmäßigem CSS-Text zurückgibt.
Syntax
js
toString()
Parameter
Keine.
Rückgabewert
Eine Zeichenkette.
Beschreibung
Die genaue Serialisierung des Objekts in eine 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üngliche Zeichenkette zurück, die geparst wurde. - Wenn das Objekt direkt konstruiert wurde, wie z. B. mit einer
CSS-Fabrikfunktion oder einem Unterklassenkonstruktor, wird die zurückgegebene Zeichenkette gemäß den Serialisierungsregeln erstellt, die spezifisch für diese Unterklasse sind. - Wenn das Objekt aus dem CSSOM gelesen wurde, wie z. B. mit
Element.computedStyleMap()oderHTMLElement.attributeStyleMap, folgt die zurückgegebene Zeichenkette den CSSOM-Serialisierungsregeln.
Für weitere Informationen zu den Serialisierungsregeln siehe Wann und wie Werte serialisiert werden in CSS-Wertserialisierung.
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 |