SVGAngle

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 SVGAngle-Schnittstelle wird verwendet, um einen Wert darzustellen, der entweder ein <angle> oder ein <number> Wert sein kann.

Das von SVGAnimatedAngle.animVal und SVGAnimatedAngle.baseVal zurückgegebene SVGAngle ist schreibgeschützt, jedoch das von SVGSVGElement.createSVGAngle() zurückgegebene SVGAngle ist beschreibbar. Wenn es als schreibgeschützt bezeichnet ist, führen Versuche, das Objekt zu ändern, zu einer Ausnahme.

Ein SVGAngle-Objekt kann mit einem bestimmten Element verknüpft sein. Das zugeordnete Element wird verwendet, um zu bestimmen, welches Inhaltselement-Attribut aktualisiert wird, wenn das Objekt ein Attribut widerspiegelt. Sofern nicht anders beschrieben, ist ein SVGAngle-Objekt keinem Element zugeordnet.

Jedes SVGAngle-Objekt arbeitet in einem von zwei Modi:

Den Basiswert widerspiegeln eines reflexiven animierbaren Attributs (wird durch das baseVal-Mitglied eines SVGAnimatedAngle exponiert),
Ungebunden sein, was der Fall für SVGAngle-Objekte ist, die mit SVGSVGElement.createSVGAngle() erstellt wurden.

Konstanten

SVG_ANGLETYPE_UNKNOWN: Ein unbekannter Wertetyp.
SVG_ANGLETYPE_UNSPECIFIED: Ein einheitenloser <number>, der als Wert in Grad interpretiert wird.
SVG_ANGLETYPE_DEG: Ein <angle> mit einer deg-Einheit.
SVG_ANGLETYPE_RAD: Ein <angle> mit einer rad-Einheit.
SVG_ANGLETYPE_GRAD: Ein <angle> mit einer grad-Einheit.

Instanz-Eigenschaften

unitType

Der Werttyp, wie von einem der auf dieser Schnittstelle definierten SVG_ANGLETYPE_* Konstanten angegeben.

value

Der Wert als Gleitkommawert, in Benutzereinheiten. Das Setzen dieses Attributs führt dazu, dass valueInSpecifiedUnits und valueAsString automatisch aktualisiert werden, um diese Einstellung zu widerspiegeln.

Ausnahmen beim Setzen: Ein DOMException mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Länge einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

valueInSpecifiedUnits

Der Wert als Gleitkommawert, in den Einheiten, die durch unitType ausgedrückt werden. Das Setzen dieses Attributs führt dazu, dass value und valueAsString automatisch aktualisiert werden, um diese Einstellung zu widerspiegeln.

valueAsString

Der Wert als Zeichenfolgenwert, in den durch unitType ausgedrückten Einheiten. Das Setzen dieses Attributs führt dazu, dass value, valueInSpecifiedUnits und unitType automatisch aktualisiert werden, um diese Einstellung zu widerspiegeln.

Ausnahmen beim Setzen:

Ein DOMException mit dem Code SYNTAX_ERR wird ausgelöst, wenn die zugewiesene Zeichenfolge nicht als gültiges <angle> geparst werden kann.

Ein DOMException mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Länge einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Instanz-Methoden

newValueSpecifiedUnits

Setzen Sie den Wert als Zahl mit einem zugeordneten unitType zurück, wodurch die Werte für alle Attribute im Objekt ersetzt werden.

Ausnahmen:

Ein DOMException mit dem Code NOT_SUPPORTED_ERR wird ausgelöst, wenn unitType SVG_ANGLETYPE_UNKNOWN ist oder kein gültiger Einheitstyp-Konstante ist (eine der anderen SVG_ANGLETYPE_* Konstanten, die auf dieser Schnittstelle definiert sind).
Ein DOMException mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Länge einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

convertToSpecifiedUnits

Behalten Sie den gleichen zugrunde liegenden gespeicherten Wert bei, setzen Sie jedoch den gespeicherten Einheitenbezeichner auf den angegebenen unitType zurück. Objektattribute unitType, valueInSpecifiedUnits und valueAsString können infolge dieser Methode geändert werden.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2 # InterfaceSVGAngle

Browser-Kompatibilität

BCD tables only load in the browser