SVG
The convertToSpecifiedUnits() method of the SVGLength interface allows you to convert the length's value to the specified unit type.
This function will:
- Set the SVGLength.unitType property to the given unit type
- Update the SVGLength.valueInSpecifiedUnits and SVGLength.valueAsString properties so the length value is represented in the given unit type
Syntax
convertToSpecifiedUnits(unitType)
Parameters
unitType- : A constant representing the unit type to which the length's value should be converted. This must be one of the constant values defined for the SVGLength.unitType property, with the exception of
SVG_LENGTHTYPE_UNKNOWN.SVGLength.SVG_LENGTHTYPE_NUMBER: convert to unitless numberSVGLength.SVG_LENGTHTYPE_PERCENTAGE: convert to percentageSVGLength.SVG_LENGTHTYPE_EMS: convert to em unitsSVGLength.SVG_LENGTHTYPE_EXS: convert to ex unitsSVGLength.SVG_LENGTHTYPE_PX: convert to pixelsSVGLength.SVG_LENGTHTYPE_CM: convert to centimetersSVGLength.SVG_LENGTHTYPE_MM: convert to millimetersSVGLength.SVG_LENGTHTYPE_IN: convert to inchesSVGLength.SVG_LENGTHTYPE_PT: convert to pointsSVGLength.SVG_LENGTHTYPE_PC: convert to picas
- : A constant representing the unit type to which the length's value should be converted. This must be one of the constant values defined for the SVGLength.unitType property, with the exception of
Return value
None (undefined).
Examples
Converting a length to mm
// 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"
Specifications
Browser compatibility
See also
- SVGAnimatedLength
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
