SVGAngle
SVGAngle
接口用于表示可以是 <angle>
或 <number>
值的值。
从 SVGAnimatedAngle.animVal
和 SVGAnimatedAngle.baseVal
返回的 SVGAngle
是只读的,但从 SVGSVGElement.createSVGAngle()
返回的 SVGAngle
是可写的。当指定为只读时,尝试修改对象将导致抛出异常。
SVGAngle
对象可以与特定元素相关联。关联的元素用于确定如果对象反映属性,则要更新哪个元素的内容属性。除非另有说明,否则 SVGAngle
对象不与任何元素相关联。
每个 SVGAngle
对象都以两种模式之一运行
- 反映基本值 反映的可动画属性(通过
baseVal
成员公开,该成员属于SVGAnimatedAngle
), - 处于分离状态,这是使用
SVGSVGElement.createSVGAngle()
创建的SVGAngle
对象的情况。
常量
SVG_ANGLETYPE_UNKNOWN
-
某种未知类型的数值。
SVG_ANGLETYPE_UNSPECIFIED
-
无单位的
<number>
被解释为度数值。 SVG_ANGLETYPE_DEG
-
具有
deg
单位的<angle>
。 SVG_ANGLETYPE_RAD
-
具有
rad
单位的<angle>
。 SVG_ANGLETYPE_GRAD
-
具有
grad
单位的<angle>
。
实例属性
unitType
-
值的类型,由在此接口上定义的
SVG_ANGLETYPE_*
常量之一指定。 value
-
以用户单位表示的浮点数值。设置此属性将导致
valueInSpecifiedUnits
和valueAsString
自动更新以反映此设置。设置时的异常:当长度对应于只读属性或对象本身是只读时,将引发具有代码
NO_MODIFICATION_ALLOWED_ERR
的DOMException
。 valueInSpecifiedUnits
-
以
unitType
表达的单位表示的浮点数值。设置此属性将导致value
和valueAsString
自动更新以反映此设置。设置时的异常:当长度对应于只读属性或对象本身是只读时,将引发具有代码
NO_MODIFICATION_ALLOWED_ERR
的DOMException
。 valueAsString
-
以
unitType
表达的单位表示的字符串值。设置此属性将导致value
、valueInSpecifiedUnits
和unitType
自动更新以反映此设置。设置时的异常
如果分配的字符串无法解析为有效的
<angle>
,将引发具有代码SYNTAX_ERR
的DOMException
。当长度对应于只读属性或对象本身是只读时,将引发具有代码
NO_MODIFICATION_ALLOWED_ERR
的DOMException
。
实例方法
newValueSpecifiedUnits
-
以关联的
unitType
重置数值,从而替换对象上所有属性的值。异常
- 如果
unitType
为SVG_ANGLETYPE_UNKNOWN
或不是有效的单位类型常量(在此接口上定义的其他SVG_ANGLETYPE_*
常量之一),将引发具有代码NOT_SUPPORTED_ERR
的DOMException
。 - 当长度对应于只读属性或对象本身是只读时,将引发具有代码
NO_MODIFICATION_ALLOWED_ERR
的DOMException
。
- 如果
convertToSpecifiedUnits
-
保留相同的基础存储值,但将存储的单位标识符重置为给定的
unitType
。对象属性unitType
、valueInSpecifiedUnits
和valueAsString
可能会在此方法的结果中被修改。
规范
规范 |
---|
可缩放矢量图形 (SVG) 2 # InterfaceSVGAngle |
浏览器兼容性
BCD 表格仅在浏览器中加载