diff --git a/files/ja/web/api/svglength/index.md b/files/ja/web/api/svglength/index.md new file mode 100644 index 00000000000000..254b949d8631e0 --- /dev/null +++ b/files/ja/web/api/svglength/index.md @@ -0,0 +1,320 @@ +--- +title: SVGLength +slug: Web/API/SVGLength +l10n: + sourceCommit: b25d8774aa7bcc6a053e26cf804ad454f51e134b +--- + +{{APIRef("SVG")}} + +## SVG length インターフェイス + +`SVGLength` インターフェイスは、[\](/ja/docs/Web/SVG/Content_type#length) 基本データ型に対応します。 + +`SVGLength` オブジェクトは読み取り専用として指定されていることがあり、その場合はオブジェクトを変更しようとすると例外が発生します。 + +### インターフェイス概要 + + + + + + + + + + + + + + + + + + + + + + + + +
実装しているものなし
メソッド +
    +
  • + void newValueSpecifiedUnits(in unsigned short + unitType, in float + valueInSpecifiedUnits) +
    • +
  • + void convertToSpecifiedUnits(in unsigned short + unitType) +
    • +
+
プロパティ +
    +
  • readonly unsigned short unitType
    • +
  • float value
    • +
  • float valueInSpecifiedUnits
    • +
  • + string valueAsString +
    • +
+
定数 +
    +
  • SVG_LENGTHTYPE_UNKNOWN = 0
    • +
  • SVG_LENGTHTYPE_NUMBER = 1
    • +
  • SVG_LENGTHTYPE_PERCENTAGE = 2
    • +
  • SVG_LENGTHTYPE_EMS = 3
    • +
  • SVG_LENGTHTYPE_EXS = 4
    • +
  • SVG_LENGTHTYPE_PX = 5
    • +
  • SVG_LENGTHTYPE_CM = 6
    • +
  • SVG_LENGTHTYPE_MM = 7
    • +
  • SVG_LENGTHTYPE_IN = 8
    • +
  • SVG_LENGTHTYPE_PT = 9
    • +
  • SVG_LENGTHTYPE_PC = 10
    • +
+
正規文書 + SVG 1.1 (2nd Edition) +
+ +## 例 + +```xml + + + + +``` + +Results on a desktop monitor (pixel units will be dpi-dependent): + +```plain +value: 37.7952766418457, valueInSpecifiedUnits: 6: 1, valueAsString: 1cm +value: 26.66666603088379, valueInSpecifiedUnits 9: 20, valueAsString: 20pt +value: 26.66666603088379, valueInSpecifiedUnits 8: 0.277777761220932, valueAsString: 0.277778in +``` + +## 定数 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名前値説明
SVG_LENGTHTYPE_UNKNOWN0 + 単位の型が定義済みの単位の型ではありません。この型の新しい値を定義しようとしたり、既存の値をこの型に切り替えようとしたりすることはできません。 +
SVG_LENGTHTYPE_NUMBER1 + 単位の型が指定されておらず（すなわち、単位のない値が指定されています）。ユーザー単位での値を示しています。 +
SVG_LENGTHTYPE_PERCENTAGE2パーセント値が指定されていました。
SVG_LENGTHTYPE_EMS3値が em 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_EXS4値が ex 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_PX5値が px 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_CM6値が cm 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_MM7値が mm 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_IN8値が in 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_PT9値が pt 単位（CSS2 で定義）を使用して指定されていました。
SVG_LENGTHTYPE_PC10値が pc 単位（CSS2 で定義）を使用して指定されていました。
+ +## インスタンスプロパティ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名前型解説
unitTypeunsigned short + 値の型で、このインターフェイスで定義されている SVG_LENGTHTYPE_* 定数のいずれかで指定されます。 +
valuefloat +

+ ユーザー単位における浮動小数点数値としての値。この属性を設定すると、この設定を反映して、valueInSpecifiedUnits と valueAsString が自動的に更新されます。 +

+

+ 設定時の例外: 長さが読み取り専用属性に対応している場合、またはオブジェクト自体が読み取り専用である場合に、{{ domxref("DOMException") }} 例外が NO_MODIFICATION_ALLOWED_ERR のコードで発生します。 +

+
valueInSpecifiedUnitsfloat +

+ unitType で指定された単位における浮動小数点数としての値。この属性を設定すると、value および valueAsString が自動的に更新され、この設定が反映されます。 +

+

+ 設定時の例外: 長さが読み取り専用属性に対応している場合、またはオブジェクト自体が読み取り専用である場合に、{{ domxref("DOMException") }} 例外が NO_MODIFICATION_ALLOWED_ERR のコードで発生します。 +

+
valueAsStringstring +

+ unitType で指定された単位での文字列値。この属性を設定すると、value、valueInSpecifiedUnits、unitType が自動的に更新され、この設定が反映されます。 +

+

設定時の例外:

+
    +
  • + 代入された文字列が有効な <length> として解釈できない場合、{{ domxref("DOMException") }} 例外が SYNTAX_ERR のコードで発生します。 +
    • +
  • + 長さが読み取り専用属性に対応している場合、またはオブジェクト自体が読み取り専用である場合に、{{ domxref("DOMException") }} 例外が NO_MODIFICATION_ALLOWED_ERR のコードで発生します。 +
    • +
+
+ +## インスタンスメソッド + + + + + + + + + + + + + + + + + + + + + +
名前と引数返値説明
+ newValueSpecifiedUnits(in unsigned short + unitType, in float valueInSpecifiedUnits) + void +

+ 関連する unitType を伴う数値として値をリセットし、それによってこのオブジェクト上のすべての属性の値を置き換えます。 +

+

例外:

+
    +
  • + unitType が SVG_LENGTHTYPE_UNKNOWN である場合、または有効な単位型定数（このインターフェイスで定義されている他の SVG_LENGTHTYPE_* 定数のいずれか）でない場合、{{ domxref("DOMException") }} が NOT_SUPPORTED_ERR のコードで発生します。 +
    • +
  • + 長さが読み取り専用属性に一致する場合、またはオブジェクト自体が読み取り専用である場合に、{{ domxref("DOMException") }} が NO_MODIFICATION_ALLOWED_ERR のコードで発生します。 +
    • +
+
+ convertToSpecifiedUnits(in unsigned short + unitType) + void + ベースとして保存された値は同じままですが、格納された単位識別子は指定された unitType にリセットされます。このメソッドの結果として、オブジェクトの unitType、valueInSpecifiedUnits、valueAsString の各属性が変更される場合があります。例えば、元の値が "0.5cm" で、ミリメートルへの変換を呼び出した場合、 unitType は SVG_LENGTHTYPE_MM に、valueInSpecifiedUnits は数値 5 に、valueAsString は "5mm" に変更されます。 +
+ +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}}