CSS Typed Object Model API
The toString() method of the CSSStyleValue interface is a stringifier that returns the value formatted as a string of standard CSS text.
Syntax
toString()
Parameters
None.
Return value
A string.
Description
The exact serialization of the object to a string depends on how the CSSStyleValue object was obtained:
- If the object was created by parsing a CSS string, such as with CSSStyleValue.parse_static, the method returns the original string that was parsed.
- If the object was constructed directly, such as with a
CSSfactory function or a subclass constructor, the returned string is generated according to serialization rules specific to that subclass. - If the object was read from the CSSOM, such as with Element.computedStyleMap() or HTMLElement.attributeStyleMap, the returned string follows the CSSOM serialization rules.
For more information about serialization rules see When and how values are serialized in CSS value serialization.
Examples
Basic usage
// 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"
Specifications
Browser compatibility
See also
- Using the CSS Typed OM
- CSSStyleValue.parse_static
- CSSStyleValue.parseAll_static
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
