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.
SVGAngle
インターフェイスは、 <angle>
または <number>
である値を表すために使用することができます。
SVGAngle
は、 SVGAnimatedAngle.animVal
および SVGAnimatedAngle.baseVal
から返された場合は読み取り専用ですが、 SVGAngle
が SVGSVGElement.createSVGAngle()
から返された場合は書き込み可能です。読み取り専用として指定された場合、オブジェクトを変更しようとすると例外が発生します。
SVGAngle
オブジェクトは、特定の要素に結び付けることができます。 関連付けられた要素は、オブジェクトが属性を反映する場合に、どの要素のコンテンツ属性を更新するかを決定するために使用されます。 特に指定のない限り、 SVGAngle
オブジェクトはどの要素にも関連付けられていません。
すべての SVGAngle
オブジェクトは、 2 つのモードのうちどちらかで操作します。
- ベース値の反映、これはアニメーション可能な属性から反映されたものです(
SVGAnimatedAngle
のbaseVal
メンバーを通じて公開されます)。 - 独立モード、これは
SVGAngle
オブジェクトがSVGSVGElement.createSVGAngle()
で作成された場合です。
定数
SVG_ANGLETYPE_UNKNOWN
-
未知の値の型です。数値
0
として表します。 SVG_ANGLETYPE_UNSPECIFIED
-
単位なしの
<number>
で、度の値として解釈されます。数値1
で表されます。 SVG_ANGLETYPE_DEG
-
<angle>
が度 (deg
) 単位で表されたものです。数値2
で表されます。 SVG_ANGLETYPE_RAD
-
<angle>
がラジアン (rad
) で表されたものです。数値3
で表されます。 SVG_ANGLETYPE_GRAD
-
<angle>
がグラード (grad
) で表されたものです。数値4
で表されます。
インスタンスプロパティ
SVGAngle.unitType
-
このインターフェイスで定義されている
SVG_ANGLETYPE_*
定数のいずれかを指定します。 SVGAngle.value
-
ユーザー単位における浮動小数点値としての値。この属性を設定すると、この属性を設定すると、この設定を反映して
valueInSpecifiedUnits
およびvalueAsString
が自動的に更新されます。設定時の例外: 長さが読み取り専用の属性に関連付けられている場合、またはオブジェクト自体が読み取り専用である場合に、
DOMException
がコードNO_MODIFICATION_ALLOWED_ERR
で発生します。 SVGAngle.valueInSpecifiedUnits
-
unitType
で指定された単位で表される浮動小数点数としての値。この属性を設定すると、この設定を反映してvalue
とvalueAsString
が自動的に更新されます。設定時の例外: 長さが読み取り専用の属性に関連付けられている場合、またはオブジェクト自体が読み取り専用である場合に、
DOMException
がコードNO_MODIFICATION_ALLOWED_ERR
で発生します。 SVGAngle.valueAsString
-
文字列値としての値を、
unitType
で表現された単位で表します。 この属性を設定すると、この設定を反映してvalue
、valueInSpecifiedUnits
、unitType
が自動的に更新されます。設定時の例外:
代入された文字列が有効な
<angle>
として解釈できなかった場合、DOMException
がコードSYNTAX_ERR
で発生します。長さが読み取り専用の属性に関連付けられている場合、またはオブジェクト自体が読み取り専用である場合に、
DOMException
がコードNO_MODIFICATION_ALLOWED_ERR
で発生します。
インスタンスメソッド
SVGAngle.newValueSpecifiedUnits
-
値を関連付けられた unitType を持つ数値としてリセットし、それによってオブジェクト上の属性の値をすべて置き換えます。
例外:
unitType
がSVG_ANGLETYPE_UNKNOWN
であるか、有効な単位型の定数(これ以外にも、このインターフェイスで定義されているSVG_ANGLETYPE_*
定数があります)ではない場合、DOMException
がコードNOT_SUPPORTED_ERR
で発生します。- この値が読み取り専用属性に対応している場合、またはオブジェクト自体が読み取り専用である場合、
DOMException
がコードNO_MODIFICATION_ALLOWED_ERR
で発生します。
SVGAngle.convertToSpecifiedUnits
-
根底に保存されたのと同じ値を維持しますが、格納された単位識別子を指定された
unitType
にリセットします。 このメソッドの結果として、オブジェクトの属性unitType
、valueInSpecifiedUnits
、valueAsString
が変更される場合があります。
仕様書
Specification |
---|
Scalable Vector Graphics (SVG) 2 # InterfaceSVGAngle |