MDN self-hosted library · e01.org

CSSUnparsedValue: CSSUnparsedValue() constructor

CSS Typed Object Model API

CSS Typed Object Model API

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

new CSSUnparsedValue(members)

Parameters

  • members
  • : An array whose values must be either a string or a CSSVariableReferenceValue.

Examples

Basic usage

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).

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

Browser compatibility

See also