MDN self-hosted library · e01.org

CSSMathSum: values property

CSS Typed Object Model API

Open notebook · 2 cells web-api-instance-property upstream source

CSS Typed Object Model API

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

Value

A CSSNumericArray.

Examples

Basic usage

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

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.

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

Browser compatibility