SVGLength: convertToSpecifiedUnits()-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 convertToSpecifiedUnits()-Methode des SVGLength-Interfaces ermöglicht es Ihnen, den Wert der Länge in den angegebenen Einheitstyp umzuwandeln.

Diese Funktion wird:

Syntax

js
convertToSpecifiedUnits(unitType)

Parameter

unitType

Eine Konstante, die den Einheitstyp darstellt, 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: Umwandlung in eine einheitslose Zahl
  • SVGLength.SVG_LENGTHTYPE_PERCENTAGE: Umwandlung in Prozentsatz
  • SVGLength.SVG_LENGTHTYPE_EMS: Umwandlung in "em"-Einheiten
  • SVGLength.SVG_LENGTHTYPE_EXS: Umwandlung in "ex"-Einheiten
  • SVGLength.SVG_LENGTHTYPE_PX: Umwandlung in Pixel
  • SVGLength.SVG_LENGTHTYPE_CM: Umwandlung in Zentimeter
  • SVGLength.SVG_LENGTHTYPE_MM: Umwandlung in Millimeter
  • SVGLength.SVG_LENGTHTYPE_IN: Umwandlung in Zoll
  • SVGLength.SVG_LENGTHTYPE_PT: Umwandlung in Punkte
  • SVGLength.SVG_LENGTHTYPE_PC: Umwandlung in Picas

Rückgabewert

Keiner (undefined).

Beispiele

Umwandlung einer Länge in mm

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

// Set a length value in centimeters
length.valueAsString = "0.5cm";

// Convert the length to millimeters
length.convertToSpecifiedUnits(SVGLength.SVG_LENGTHTYPE_MM);

console.log(length.unitType); // Output: 7 (SVG_LENGTHTYPE_MM)
console.log(length.valueInSpecifiedUnits); // Output: 5
console.log(length.valueAsString); // Output: "5mm"

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGLength__convertToSpecifiedUnits

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
convertToSpecifiedUnits

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch