CSSNumericValue: sub() method

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 sub() method of the CSSNumericValue interface subtracts a supplied number from the CSSNumericValue.

Syntax

js
sub()
sub(number1)
sub(number1, number2)
sub(number1, number2, /* …, */ numberN)

Parameters

number1, …, numberN Optional

Either a number or a CSSNumericValue.

Return value

A CSSMathSum, or a CSSUnitValue if this and every argument share the same unit.

Exceptions

TypeError

Thrown if an invalid type was passed to the method.

Examples

Basic usage

js
let mathSum = CSS.px(23).sub(CSS.percent(4)).sub(CSS.cm(3)).sub(CSS.in(9));
// Prints "calc(23px - 4% - 3cm - 9in)"
console.log(mathSum.toString());

Specifications

Specification
CSS Typed OM Level 1
# dom-cssnumericvalue-sub

Browser compatibility