我们的志愿者还没有将这篇文章翻译为 中文 (简体)。加入我们帮助完成翻译!
您也可以阅读此文章的English (US)版。
The SVGAngle interface is used to represent a value that can be an <angle> or <number> value. An SVGAngle reflected through the animVal attribute is always read only.
An SVGAngle object can be designated as read only, which means that 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. It can:
- reflect the base value of a reflected animatable attribute (being exposed through the
baseValmember of anSVGAnimatedAngle), - be detached, which is the case for
SVGAngleobjects 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 adegunit. - SVG_ANGLETYPE_RAD
- An
<angle>with aradunit. - SVG_ANGLETYPE_GRAD
- An
<angle>with agradunit.
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
valueInSpecifiedUnitsandvalueAsStringto be updated automatically to reflect this setting.Exceptions on setting: a
DOMExceptionwith codeNO_MODIFICATION_ALLOWED_ERRis 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 causevalueandvalueAsStringto be updated automatically to reflect this setting.Exceptions on setting: a
DOMExceptionwith codeNO_MODIFICATION_ALLOWED_ERRis raised when the length corresponds to a read only attribute or when the object itself is read only. - valueAsString
-
The value as a
DOMStringvalue, in the units expressed byunitType. Setting this attribute will causevalue,valueInSpecifiedUnitsandunitTypeto be updated automatically to reflect this setting.Exceptions on setting:
aDOMExceptionwith codeSYNTAX_ERRis raised if the assigned string cannot be parsed as a valid<angle>. aDOMExceptionwith codeNO_MODIFICATION_ALLOWED_ERRis raised when the length corresponds to a read only attribute or when the object itself is read only.
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:
aDOMExceptionwith codeNOT_SUPPORTED_ERRis raised ifunitTypeisSVG_ANGLETYPE_UNKNOWNor not a valid unit type constant (one of the otherSVG_ANGLETYPE_*constants defined on this interface). aDOMExceptionwith codeNO_MODIFICATION_ALLOWED_ERRis raised when the length corresponds to a read only attribute or when the object itself is read only. - convertToSpecifiedUnits
- Preserve the same underlying stored value, but reset the stored unit identifier to the given
unitType. Object attributesunitType,valueInSpecifiedUnitsandvalueAsStringmight be modified as a result of this method.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Scalable Vector Graphics (SVG) 2 The definition of 'SVGElement' in that specification. |
Candidate Recommendation | Adds the dataset property. |
| Scalable Vector Graphics (SVG) 1.1 (Second Edition) The definition of 'SVGElement' in that specification. |
Recommendation | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | ? | ? | ? | ? |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | ? | (Yes) | ? | ? | ? | ? |