CSSNumericValue.toSum()

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The toSum() method of the CSSNumericValue interface converts the object's value to a CSSMathSum object to values of the specified unit.

Syntax

var cssMathSum = CSSNumericValue.toSum(units);

Parameters

units

The units to convert to.

Return value

A CSSNumericValue.

Exceptions

SyntaxError

undefined

TypeError

Indicates that an invalid type was passed to the method.

Examples

let v = CSS.px("23").add(CSS.percent("4")).add(CSS.cm("3")).add(CSS.in("9"));
v.toString() // => "calc(23px + 4% + 3cm + 9in)"
v.toSum("px", "percent").toString() // => "calc(1000.39px + 4%)"

Specifications

Specification
CSS Typed OM Level 2
# dom-cssnumericvalue-tosum

Browser compatibility

BCD tables only load in the browser