SVG
The newValueSpecifiedUnits() method of the SVGLength interface resets the value as a number with an associated SVGLength.unitType, thereby replacing the values for all of the attributes on the object.
Syntax
newValueSpecifiedUnits(unitType, valueInSpecifiedUnits)
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
-
valueInSpecifiedUnits- : The numeric factor for the length value, expressed in the specified unit type.
Return value
None (undefined).
Exceptions
This method may raise a DOMException of one of the following types:
NotSupportedErrorDOMException- : Thrown if
unitTypeisSVG_LENGTHTYPE_UNKNOWNor not a valid unit type constant.
- : Thrown if
NoModificationAllowedErrorDOMException- : Thrown if SVGLength corresponds to a read-only attribute or when the object itself is read-only.
Examples
Setting a length value with specific units
// 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)
Specifications
Browser compatibility
See also
- SVGAnimatedLength
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
