SVGAngle
The SVGAngle
interface is used to represent a value that can be an <angle>
or <number>
value.
The SVGAngle
returned from SVGAnimatedAngle.animVal
and SVGAnimatedAngle.baseVal
is read only, but the SVGAngle
returned from SVGSVGElement.createSVGAngle()
is writable. When designated as read only, attempts to modify the object will result in an exception being thrown.
An SVGAngle
object can be associated with a particular element. The associated element is used to determine which element's content attribute to update if the object reflects an attribute. Unless otherwise described, an SVGAngle
object is not associated with any element.
Every SVGAngle
object operates in one of two modes:
- Reflect the base value of a reflected animatable attribute (being exposed through the
baseVal
member of anSVGAnimatedAngle
), - Be detached, which is the case for
SVGAngle
objects created withSVGSVGElement.createSVGAngle()
.
Constants
SVG_ANGLETYPE_UNKNOWN
-
Some unknown type of value.
SVG_ANGLETYPE_UNSPECIFIED
-
A unitless
<number>
interpreted as a value in degrees. SVG_ANGLETYPE_DEG
-
An
<angle>
with adeg
unit. SVG_ANGLETYPE_RAD
-
An
<angle>
with arad
unit. SVG_ANGLETYPE_GRAD
-
An
<angle>
with agrad
unit.
Instance properties
unitType
-
The type of the value as specified by one of the
SVG_ANGLETYPE_*
constants defined on this interface. value
-
The value as a floating point value, in user units. Setting this attribute will cause
valueInSpecifiedUnits
andvalueAsString
to be updated automatically to reflect this setting.Exceptions on setting: A
DOMException
with codeNO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read-only attribute, or when the object itself is read-only. valueInSpecifiedUnits
-
The value as a floating point value, in the units expressed by
unitType
. Setting this attribute will causevalue
andvalueAsString
to be updated automatically to reflect this setting.Exceptions on setting: A
DOMException
with codeNO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read-only attribute, or when the object itself is read-only. valueAsString
-
The value as a string value, in the units expressed by
unitType
. Setting this attribute will causevalue
,valueInSpecifiedUnits
, andunitType
to be updated automatically to reflect this setting.Exceptions on setting:
A
DOMException
with codeSYNTAX_ERR
is raised if the assigned string cannot be parsed as a valid<angle>
.A
DOMException
with codeNO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read-only attribute, or when the object itself is read-only.
Instance methods
newValueSpecifiedUnits
-
Reset the value as a number with an associated unitType, thereby replacing the values for all of the attributes on the object.
Exceptions:
- A
DOMException
with codeNOT_SUPPORTED_ERR
is raised ifunitType
isSVG_ANGLETYPE_UNKNOWN
or not a valid unit type constant (one of the otherSVG_ANGLETYPE_*
constants defined on this interface). - A
DOMException
with codeNO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read only attribute or when the object itself is read only.
- A
convertToSpecifiedUnits
-
Preserve the same underlying stored value, but reset the stored unit identifier to the given
unitType
. Object attributesunitType
,valueInSpecifiedUnits
, andvalueAsString
might be modified as a result of this method.
Specifications
Specification |
---|
Scalable Vector Graphics (SVG) 2 # InterfaceSVGAngle |
Browser compatibility
BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.