CSSMathSum: values property
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 values read-only property of the CSSMathSum interface returns a CSSNumericArray containing the CSSNumericValue objects being summed together.
Value
Examples
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
| Specification |
|---|
| CSS Typed OM Level 1 # dom-cssmathsum-values |