SVGLength: newValueSpecifiedUnits() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die newValueSpecifiedUnits()-Methode der SVGLength-Schnittstelle setzt den Wert als Zahl mit einem zugehörigen unitType zurück und ersetzt dadurch die Werte aller Attribute des Objekts.

Syntax

js
newValueSpecifiedUnits(unitType, valueInSpecifiedUnits)

Parameter

unitType

Eine Konstante, die den Einheitstyp repräsentiert, in den der Längenwert umgewandelt werden soll. Dies muss einer der konstanten Werte sein, die für die unitType-Eigenschaft definiert sind, mit Ausnahme von SVG_LENGTHTYPE_UNKNOWN.

  • SVGLength.SVG_LENGTHTYPE_NUMBER: in einheitenlose Zahl umwandeln
  • SVGLength.SVG_LENGTHTYPE_PERCENTAGE: in Prozentsatz umwandeln
  • SVGLength.SVG_LENGTHTYPE_EMS: in EM-Einheiten umwandeln
  • SVGLength.SVG_LENGTHTYPE_EXS: in EX-Einheiten umwandeln
  • SVGLength.SVG_LENGTHTYPE_PX: in Pixel umwandeln
  • SVGLength.SVG_LENGTHTYPE_CM: in Zentimeter umwandeln
  • SVGLength.SVG_LENGTHTYPE_MM: in Millimeter umwandeln
  • SVGLength.SVG_LENGTHTYPE_IN: in Zoll umwandeln
  • SVGLength.SVG_LENGTHTYPE_PT: in Punkte umwandeln
  • SVGLength.SVG_LENGTHTYPE_PC: in Picas umwandeln
valueInSpecifiedUnits

Der numerische Faktor für den Längenwert, ausgedrückt in der angegebenen Einheit.

Rückgabewert

Keiner (undefined).

Ausnahmen

Diese Methode kann eine DOMException der folgenden Typen auslösen:

NotSupportedError DOMException

Wird ausgelöst, wenn unitType SVG_LENGTHTYPE_UNKNOWN ist oder keine gültige Einheitstypkonstante ist.

NoModificationAllowedError DOMException

Wird ausgelöst, wenn SVGLength einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Beispiele

Setzen eines Längenwerts mit spezifischen Einheiten

js
// Get an SVGLength object
const svg = document.querySelector("svg");
const length = svg.createSVGLength();

// Set a new value with specific units
length.newValueSpecifiedUnits(SVGLength.SVG_LENGTHTYPE_NUMBER, 45);
console.log(length.valueInSpecifiedUnits); // Output: 45
console.log(length.unitType); // Output: 1 (SVG_LENGTHTYPE_NUMBER)
console.log(length.value); // The value converted to the user coordinate system

// Change the value to pixels
length.newValueSpecifiedUnits(SVGLength.SVG_LENGTHTYPE_PX, 100);
console.log(length.valueInSpecifiedUnits); // Output: 100
console.log(length.unitType); // Output: 5 (SVG_LENGTHTYPE_PX)

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGLength__newValueSpecifiedUnits

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch