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 January 2020.

Die newValueSpecifiedUnits()-Methode der SVGAngle-Schnittstelle setzt den Wert auf eine Zahl mit einem zugehörigen unitType und ersetzt damit die Werte aller Attribute des Objekts.

Eine Konstante, die den Einheitstyp darstellt, in den der Winkelwert umgewandelt werden soll. Dies muss einer der konstanten Werte sein, die für die unitType-Eigenschaft definiert sind, mit Ausnahme von SVG_ANGLETYPE_UNKNOWN.

SVGAngle.SVG_ANGLETYPE_DEG: in Grad umwandeln
SVGAngle.SVG_ANGLETYPE_RAD: in Radianten umwandeln
SVGAngle.SVG_ANGLETYPE_GRAD: in Gon umwandeln
SVGAngle.SVG_ANGLETYPE_UNSPECIFIED: in eine einheitslose Zahl umwandeln, als Grad interpretiert

valueInSpecifiedUnits

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

Rückgabewert

Keiner (undefined).

Ausnahmen

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

NotSupportedError DOMException: Wird ausgelöst, wenn unitType SVG_ANGLETYPE_UNKNOWN ist oder keine gültige Einheitstypkonstante.
NoModificationAllowedError DOMException: Wird ausgelöst, wenn SVGAngle einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Beispiele

Einstellung eines Winkels in Grad

// Get an SVGAngle object
const 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 degrees
console.log(angle.value); // Output: 45
console.log(angle.unitType); // Output: 2 (SVG_ANGLETYPE_DEG)

Einstellung eines Winkels in Radianten

// Get an SVGAngle object
const 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 value
console.log(angle.value); // Output: 90
console.log(angle.unitType); // Output: 3 (SVG_ANGLETYPE_RAD)

Einstellung eines Winkels in Gon

// Get an SVGAngle object
const 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 gradians
console.log(angle.value); // Output: 90
console.log(angle.unitType); // Output: 4 (SVG_ANGLETYPE_GRAD)

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2 # __svg__SVGAngle__newValueSpecifiedUnits

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

SVGAnimatedAngle