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 Methode newValueSpecifiedUnits() der Schnittstelle SVGAngle 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 für die Eigenschaft unitType definierten konstanten Werte sein, mit Ausnahme von SVG_ANGLETYPE_UNKNOWN.

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

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 nicht einer der gültigen Einheitstypkonstanten ist.
NoModificationAllowedError DOMException: Wird ausgelöst, wenn SVGAngle einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Beispiele

Einstellen 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)

Einstellen 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)

Einstellen 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