CSSNumericValue: toSum() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die toSum()-Methode der CSSNumericValue-Schnittstelle konvertiert den Wert des Objekts in eine CSSMathSum von CSSUnitValues, indem nur die angegebenen Einheiten verwendet werden, wenn möglich. Wenn sie ohne Einheiten aufgerufen wird, vereinfacht sie den Wert stattdessen in eine minimale Summe von CSSUnitValues.
Syntax
js
toSum()
toSum(unit1)
toSum(unit1, unit2)
toSum(unit1, unit2, /* …, */ unitN)
Parameter
unit1, …,unitNOptional-
Die Einheiten, in die konvertiert werden soll.
Rückgabewert
Eine CSSMathSum.
Ausnahmen
SyntaxErrorDOMException-
Wird ausgelöst, wenn eine der
unit1, …,unitNkeine gültige Einheit ist. TypeError-
Wird ausgelöst, wenn:
- Der Wert nicht als Summe von
CSSUnitValues ausgedrückt werden kann — zum Beispiel, weil einer seiner Terme eine zusammengesetzte Einheit (wiepx * s) hat, die nicht durch einen einzelnenCSSUnitValuedargestellt werden kann. - Eine oder mehrere Einheiten an die Methode übergeben wurden und der Wert einen Term enthält, dessen Einheit mit keiner von ihnen kompatibel ist.
- Der Wert nicht als Summe von
Beispiele
Grundlegende Verwendung
js
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%)"
Spezifikationen
| Spezifikation |
|---|
| CSS Typed OM Level 1 # dom-cssnumericvalue-tosum |