CSSMathSum: values property

Note: This feature is available in Web Workers.

The values read-only property of the CSSMathSum interface returns a CSSNumericArray containing the CSSNumericValue objects being summed together.

Value

A CSSNumericArray.

Examples

undefined

Basic usage

The following code creates a CSSMathSum object and logs its values and length.

js
const sum = new CSSMathSum(CSS.px(10), CSS.em(5), CSS.percent(50));

console.log(sum.values);
// CSSNumericArray {0: CSSUnitValue, 1: CSSUnitValue, 2: CSSUnitValue, length: 3}
console.log(sum.values.length); // 3

We then iterate over the values, logging their type, value, unit, and stringified text. Each of these matches the CSSNumericValue objects that were passed into the constructor (or the terms of the addition/subtraction it represents), in the same order.

js
for (const value of sum.values) {
  console.log(
    `${value.constructor.name}: ${value.value} ${value.unit} (${value})`,
  );
}

// CSSUnitValue: 10 px (10px)
// CSSUnitValue: 5 em (5em)
// CSSUnitValue: 50 percent (50%)

Specifications