CSSUnparsedValue: CSSUnparsedValue() constructor
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Want more browser support for this feature? Tell us why.
Note: This feature is available in Web Workers.
The CSSUnparsedValue() constructor creates a new CSSUnparsedValue object, which represents a property value that can't be parsed into a more specific type — typically the value of a custom property.
Syntax
js
new CSSUnparsedValue(members)
Parameters
members-
An array whose values must be either a string or a
CSSVariableReferenceValue.
Examples
Basic usage
js
const value = new CSSUnparsedValue(["4deg"]);
const values = new CSSUnparsedValue(["1em", "#445566", "-45px"]);
console.log(value); // CSSUnparsedValue {0: "4deg", length: 1}
console.log(values); // CSSUnparsedValue {0: "1em", 1: "#445566", 2: "-45px", length: 3}
CSSUnparsedValue with a variable reference
A member can also be a CSSVariableReferenceValue, representing a var() reference embedded in the value.
This example builds a CSSUnparsedValue for a declaration equivalent to 10px var(--bar, blue).
js
const fallback = new CSSUnparsedValue(["blue"]);
const varRef = new CSSVariableReferenceValue("--bar", fallback);
const value = new CSSUnparsedValue(["10px ", varRef]);
console.log(value.length); // 2
console.log(value[0]); // "10px "
console.log(value[1].variable); // "--bar"
console.log(value[1].fallback[0]); // "blue"
Specifications
| Specification |
|---|
| CSS Typed OM Level 1 # dom-cssunparsedvalue-cssunparsedvalue |