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, aber das von SVGSVGElement.createSVGAngle() zurückgegebene SVGAngle ist beschreibbar. Wenn es als schreibgeschützt bezeichnet wird, führt ein Versuch, das Objekt zu ändern, zu einer Ausnahme.

Ein SVGAngle-Objekt kann mit einem bestimmten Element verknüpft sein. Das verknüpfte Element wird verwendet, um zu bestimmen, welches Content-Attribut des Elements aktualisiert werden soll, wenn das Objekt ein Attribut widerspiegelt. Sofern nicht anders beschrieben, ist ein SVGAngle-Objekt nicht mit einem Element verknüpft.

Jedes SVGAngle-Objekt arbeitet in einem von zwei Modi:

  1. Den Basiswert eines animierbaren Attributs widerspiegeln (wird über das baseVal Mitglied eines SVGAnimatedAngle offengelegt),
  2. Wird gelöst, was für SVGAngle-Objekte der Fall ist, die mit SVGSVGElement.createSVGAngle() erstellt wurden.

Konstanten

SVG_ANGLETYPE_UNKNOWN

Ein unbekannter Wertetyp. Dargestellt als numerischer Wert 0.

SVG_ANGLETYPE_UNSPECIFIED

Ein einheitenloses <number>, das als Wert in Grad interpretiert wird. Dargestellt als numerischer Wert 1.

SVG_ANGLETYPE_DEG

Ein <angle> mit einer deg-Einheit. Dargestellt als numerischer Wert 2.

SVG_ANGLETYPE_RAD

Ein <angle> mit einer rad-Einheit. Dargestellt als numerischer Wert 3.

SVG_ANGLETYPE_GRAD

Ein <angle> mit einer grad-Einheit. Dargestellt als numerischer Wert 4.

Instanz-Eigenschaften

SVGAngle.unitType

Der Typ des Wertes, wie er durch eine der auf dieser Schnittstelle definierten SVG_ANGLETYPE_* Konstanten angegeben wird.

SVGAngle.value

Der Wert als Gleitkommawert in Benutzereinheiten. Das Setzen dieses Attributs bewirkt, dass valueInSpecifiedUnits und valueAsString automatisch aktualisiert werden, um diese Einstellung widerzuspiegeln.

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.

SVGAngle.valueInSpecifiedUnits

Der Wert als Gleitkommawert in den durch unitType ausgedrückten Einheiten. Das Setzen dieses Attributs bewirkt, dass value und valueAsString automatisch aktualisiert werden, um diese Einstellung widerzuspiegeln.

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.

SVGAngle.valueAsString

Der Wert als Zeichenkettenwert in den durch unitType ausgedrückten Einheiten. Das Setzen dieses Attributs bewirkt, dass value, valueInSpecifiedUnits und unitType automatisch aktualisiert werden, um diese Einstellung widerzuspiegeln.

Ausnahmen beim Setzen:

Ein DOMException mit dem Code SYNTAX_ERR wird ausgelöst, wenn die zugewiesene Zeichenkette nicht als gültiger <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

SVGAngle.newValueSpecifiedUnits

Setzt den Wert als eine Zahl mit einem zugehörigen unitType zurück und ersetzt dadurch die Werte aller Attribute des Objekts.

Ausnahmen:

  • Ein DOMException mit dem Code NOT_SUPPORTED_ERR wird ausgelöst, wenn unitType SVG_ANGLETYPE_UNKNOWN oder kein gültiger Einheitentyp ist (einer der anderen auf dieser Schnittstelle definierten SVG_ANGLETYPE_* Konstanten).
  • 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.
SVGAngle.convertToSpecifiedUnits

Bewahrt den gleichen zugrunde liegenden gespeicherten Wert, setzt aber den gespeicherten Einheitentyp auf den angegebenen unitType zurück. Objektattribute unitType, valueInSpecifiedUnits und valueAsString könnten durch diese Methode modifiziert werden.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# InterfaceSVGAngle

Browser-Kompatibilität

BCD tables only load in the browser