SVGAngle

SVGAngle 接口用于表示可以是 <angle><number> 值的值。

SVGAnimatedAngle.animValSVGAnimatedAngle.baseVal 返回的 SVGAngle 是只读的,但从 SVGSVGElement.createSVGAngle() 返回的 SVGAngle 是可写的。当指定为只读时,尝试修改对象将导致抛出异常。

SVGAngle 对象可以与特定元素相关联。关联的元素用于确定如果对象反映属性,则要更新哪个元素的内容属性。除非另有说明,否则 SVGAngle 对象不与任何元素相关联。

每个 SVGAngle 对象都以两种模式之一运行

  1. 反映基本值 反映的可动画属性(通过 baseVal 成员公开,该成员属于 SVGAnimatedAngle),
  2. 处于分离状态,这是使用 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

以用户单位表示的浮点数值。设置此属性将导致 valueInSpecifiedUnitsvalueAsString 自动更新以反映此设置。

设置时的异常:当长度对应于只读属性或对象本身是只读时,将引发具有代码 NO_MODIFICATION_ALLOWED_ERRDOMException

valueInSpecifiedUnits

unitType 表达的单位表示的浮点数值。设置此属性将导致 valuevalueAsString 自动更新以反映此设置。

设置时的异常:当长度对应于只读属性或对象本身是只读时,将引发具有代码 NO_MODIFICATION_ALLOWED_ERRDOMException

valueAsString

unitType 表达的单位表示的字符串值。设置此属性将导致 valuevalueInSpecifiedUnitsunitType 自动更新以反映此设置。

设置时的异常

如果分配的字符串无法解析为有效的 <angle>,将引发具有代码 SYNTAX_ERRDOMException

当长度对应于只读属性或对象本身是只读时,将引发具有代码 NO_MODIFICATION_ALLOWED_ERRDOMException

实例方法

newValueSpecifiedUnits

以关联的 unitType 重置数值,从而替换对象上所有属性的值。

异常

  • 如果 unitTypeSVG_ANGLETYPE_UNKNOWN 或不是有效的单位类型常量(在此接口上定义的其他 SVG_ANGLETYPE_* 常量之一),将引发具有代码 NOT_SUPPORTED_ERRDOMException
  • 当长度对应于只读属性或对象本身是只读时,将引发具有代码 NO_MODIFICATION_ALLOWED_ERRDOMException
convertToSpecifiedUnits

保留相同的基础存储值,但将存储的单位标识符重置为给定的 unitType。对象属性 unitTypevalueInSpecifiedUnitsvalueAsString 可能会在此方法的结果中被修改。

规范

规范
可缩放矢量图形 (SVG) 2
# InterfaceSVGAngle

浏览器兼容性

BCD 表格仅在浏览器中加载