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 から返された場合は読み取り専用ですが、 SVGAngleSVGSVGElement.createSVGAngle() から返された場合は書き込み可能です。読み取り専用として指定された場合、オブジェクトを変更しようとすると例外が発生します。

SVGAngle オブジェクトは、特定の要素に結び付けることができます。 関連付けられた要素は、オブジェクトが属性を反映する場合に、どの要素のコンテンツ属性を更新するかを決定するために使用されます。 特に指定のない限り、 SVGAngle オブジェクトはどの要素にも関連付けられていません。

すべての SVGAngle オブジェクトは、 2 つのモードのうちどちらかで操作します。

  1. ベース値の反映、これはアニメーション可能な属性から反映されたものです(SVGAnimatedAnglebaseVal メンバーを通じて公開されます)。
  2. 独立モード、これは 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 で指定された単位で表される浮動小数点数としての値。この属性を設定すると、この設定を反映して valuevalueAsString が自動的に更新されます。

設定時の例外: 長さが読み取り専用の属性に関連付けられている場合、またはオブジェクト自体が読み取り専用である場合に、 DOMException がコード NO_MODIFICATION_ALLOWED_ERR で発生します。

SVGAngle.valueAsString

文字列値としての値を、unitType で表現された単位で表します。 この属性を設定すると、この設定を反映して valuevalueInSpecifiedUnitsunitType が自動的に更新されます。

設定時の例外:

代入された文字列が有効な<angle> として解釈できなかった場合、 DOMException がコード SYNTAX_ERR で発生します。

長さが読み取り専用の属性に関連付けられている場合、またはオブジェクト自体が読み取り専用である場合に、 DOMException がコード NO_MODIFICATION_ALLOWED_ERR で発生します。

インスタンスメソッド

SVGAngle.newValueSpecifiedUnits

値を関連付けられた unitType を持つ数値としてリセットし、それによってオブジェクト上の属性の値をすべて置き換えます。

例外:

  • unitTypeSVG_ANGLETYPE_UNKNOWN であるか、有効な単位型の定数(これ以外にも、このインターフェイスで定義されている SVG_ANGLETYPE_* 定数があります)ではない場合、 DOMException がコード NOT_SUPPORTED_ERR で発生します。
  • この値が読み取り専用属性に対応している場合、またはオブジェクト自体が読み取り専用である場合、 DOMException がコード NO_MODIFICATION_ALLOWED_ERR で発生します。
SVGAngle.convertToSpecifiedUnits

根底に保存されたのと同じ値を維持しますが、格納された単位識別子を指定された unitType にリセットします。 このメソッドの結果として、オブジェクトの属性 unitTypevalueInSpecifiedUnitsvalueAsString が変更される場合があります。

仕様書

Specification
Scalable Vector Graphics (SVG) 2
# InterfaceSVGAngle

ブラウザーの互換性