SVGAngle: 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 ⁨Juli 2015⁩.

DienewValueSpecifiedUnits()-Methode desSVGAngle-Interfaces setzt den Wert auf eine Zahl mit einem zugehörigenunitType und ersetzt damit die Werte aller Attribute des Objekts.

Eine Konstante, die den Einheitentyp darstellt, in den der Wert des Winkels umgewandelt werden soll. Dies muss einer der für dieunitType-Eigenschaft definierten konstanten Werte sein, mit Ausnahme vonSVG_ANGLETYPE_UNKNOWN.

SVGAngle.SVG_ANGLETYPE_DEG: Umwandlung in Grad
SVGAngle.SVG_ANGLETYPE_RAD: Umwandlung in Radiant
SVGAngle.SVG_ANGLETYPE_GRAD: Umwandlung in Gon
SVGAngle.SVG_ANGLETYPE_UNSPECIFIED: Umwandlung in eine einheitenlose Zahl, interpretiert als Grad

valueInSpecifiedUnits

Der numerische Faktor für den Winkelwert, ausgedrückt im angegebenen Einheitentyp.

Rückgabewert

Keiner (undefined).

Ausnahmen

Diese Methode kann eineDOMException einer der folgenden Typen auslösen:

NotSupportedErrorDOMException: Wird ausgelöst, wennunitTypeSVG_ANGLETYPE_UNKNOWN ist oder keine gültige Einheitentypkonstante ist.
NoModificationAllowedErrorDOMException: Wird ausgelöst, wennSVGAngle einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Beispiele

Einstellung eines Winkels in Grad

// Get an SVGAngle objectconst svg = document.querySelector("svg");const angle = svg.createSVGAngle();// Set the angle's value in degrees using newValueSpecifiedUnits()angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_DEG, 45);// Retrieve the angle's value in degreesconsole.log(angle.value); // Output: 45console.log(angle.unitType); // Output: 2 (SVG_ANGLETYPE_DEG)

Einstellung eines Winkels in Radiant

// Get an SVGAngle objectconst svg = document.querySelector("svg");const angle = svg.createSVGAngle();// Set the angle's value in radians using newValueSpecifiedUnits()angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_RAD, Math.PI / 2);// Retrieve the angle's valueconsole.log(angle.value); // Output: 90console.log(angle.unitType); // Output: 3 (SVG_ANGLETYPE_RAD)

Einstellung eines Winkels in Gon

// Get an SVGAngle objectconst svg = document.querySelector("svg");const angle = svg.createSVGAngle();// Set the angle's value in gradians using newValueSpecifiedUnits()angle.newValueSpecifiedUnits(SVGAngle.SVG_ANGLETYPE_GRAD, 100);// Retrieve the angle's value in gradiansconsole.log(angle.value); // Output: 90console.log(angle.unitType); // Output: 4 (SVG_ANGLETYPE_GRAD)