第 4 章: 基本データ型とインターフェイス

4.1. 定義

初期値

属性またはプロパティの初期値とは、その属性またはプロパティが指定されていない場合、 または無効な値を持つ場合に使用される値である。 この値は、レンダリング、アニメーション値の 計算、および DOM インターフェイスを介した属性またはプロパティへのアクセスの目的で 使用される。

無効な値

スタイルシートまたはプレゼンテーション属性のいずれかで プロパティに指定された無効な値とは、プロパティの値を定義する 文法に従って許可されていないか、文法では許可されているが 後に本文で許可されていない値である。無効な値を持つ CSS 宣言は 無視される。

4.2. 属性構文

4.2.1. 実数の精度

別途記載がない限り、SVG 属性内の数値、および SVG 要素に影響を与えると定義されたプロパティ内の数値は、 ホストアーキテクチャがサポートする少なくともすべての有限単精度値を サポートしなければならない。

可能な限り高い精度を提供し、 丸め誤差を防ぐため、座標系変換などの 操作では、より高精度の浮動小数点 記憶および計算を行うことが推奨される。

適合 SVG ビューアーは、 適合基準で説明されるように、その 適合クラスに従って数値計算を実行する必要がある。

4.2.2. 特定の範囲に制限される値のクランプ

一部の数値属性およびプロパティ値には制限された範囲がある。 その他の値はデバイスの能力によって制限される。 別途指定されていない場合、 ユーザーエージェントは範囲外エラーの確認を レンダリング処理のできるだけ遅い段階まで延期しなければならない。 これは特にデバイスの制限にとって重要である。 複合操作では、 範囲外の中間値が生成されても、 最終値は範囲内になる場合があるためである。

4.3. SVG DOM の概要

スクリプト実行をサポートする適合SVG ビューアーまたはSVG インタープリターは、 この仕様全体で定義される SVG DOM インターフェイスを、 この節に列挙される具体的な要件および依存関係とともに実装しなければならない。

4.3.1. SVG DOM サポートの依存関係

SVG DOM は Web IDL インターフェイスによって定義される。この仕様内のすべての IDL フラグメントは、 Web IDL 仕様で説明されるように、適合 IDL フラグメントに求められるとおりに解釈しなければならない。[WebIDL]

SVG DOM は多数の DOM 仕様を基礎としている。特に次のとおりである。

• SVG DOM は、この仕様が公開された時点における DOM 現行標準の最新の Review Draft で定義される DOM の完全なサポートを必要とする。ただし、それ以降に削除または非推奨となった機能を除く。 DOM をサポートする SVG ソフトウェアは、 可能な限り最新の DOM 標準を 実装すべきである [DOM]
• SVG DOM は、 UI Events および Clipboard API and events の関連する側面を サポートする必要がある （[uievents]、[clipboard-apis]）。 （必要な具体的な機能については、 UI Events との関係を参照。）
• SVG DOM は、少なくとも、 CSS Object Model (CSSOM) 仕様で 削除されていない DOM Level 2 Style （[dom-level-2-style]）のすべてのインターフェイスを 完全にサポートする必要がある。 SVG ソフトウェアは可能な限り、 CSS Object Model (CSSOM) の 最新バージョンを実装すべきである （[cssom-1]）
• SVG DOM は、 Geometry Interfaces Module Level 1 （[geometry-1]）を完全にサポートする必要がある。

4.3.2. 命名規則

SVG DOM は HTML および DOM 標準と同様の命名規則に従う （[HTML]、[DOM]）。

すべての名前は、1 つ以上の英単語を 連結して単一の文字列を形成するように定義される。プロパティ名または メソッド名は最初のキーワードを小文字で開始し、 その後の各単語は大文字で開始する。例えば、 ファイルが作成された日付などの文書メタ情報を返す プロパティには "fileDateCreated" という名前を付けることができる。

この仕様で定義されるインターフェイス名のほぼすべては "SVG" で始まる。 SVG 名前空間の要素に対応する DOM Element オブジェクトを表す インターフェイスは、 SVGElementNameElement という形式に従い、ここで ElementName は先頭文字を大文字にした要素のタグ名である。 したがって、SVGRadialGradientElement は ‘radialGradient’ 要素のインターフェイスである。

この大文字小文字規則の例外は SVGSVGElement であり、 タグ名全体が大文字になっている。

4.3.3. SVG DOM 内の要素

SVG DOM をサポートする必要がある SVG ソフトウェアはすべて、 SVG 文書 フラグメント用に作成された DOM 要素を 次のように拡張しなければならない。

• サポートされる SVG 要素（すなわち、 名前空間 URI が "http://www.w3.org/2000/svg" で、 ローカル名がこの仕様またはソフトウェアが実装する別の仕様で 定義される要素のいずれかである要素）に対応するすべての Element オブジェクトは、要素定義で特定される DOM インターフェイスも 実装しなければならない。

• ローカル名がソフトウェアによってサポートされるいずれの仕様で定義された要素にも 一致しない SVG 名前空間内の要素も、 SVGElement インターフェイスを実装しなければならない。

‘rect’ 要素では、 SVGRectElement インターフェイスが 特定されている。これは、名前空間 URI が "http://www.w3.org/2000/svg" で、 ローカル名が "rect" であるすべての Element オブジェクトが SVGRectElement も実装しなければならないことを意味する。

4.3.4. DOM へのコンテンツ属性の反映

多くの SVG DOM プロパティ（IDL 属性）は、 対応する要素上のコンテンツ属性またはプロパティを 反映する。 これは、コンテンツ属性と IDL 属性が同じ基礎データを表すことを意味する。 例えば、 SVGRectElement 内の SVGAnimatedLength ry は、 関連付けられた ‘rect’ 要素上の ry プレゼンテーション属性を反映する。

この反映を行う方法は IDL 属性の型によって異なる。

• 反映する IDL 属性の型が プリミティブ型（例えば SVGElement 上の tabIndex で使用される long）または DOMString（例えば SVGStyleElement 上の title で使用されるもの）の場合、 HTML における IDL 属性への コンテンツ属性の反映の規則を使用する。
• 反映する IDL 属性の型が SVGAnimatedBoolean、 SVGAnimatedString、SVGAnimatedEnumeration、SVGAnimatedNumber、 SVGAnimatedNumberList、SVGAnimatedLength、SVGAnimatedLengthList、 SVGAnimatedAngle、SVGAnimatedRect、または SVGAnimatedPreserveAspectRatio の場合、 反映インターフェイスを定義する対応する 節の規則を使用する。

  概略として、オブジェクトの baseVal はコンテンツ属性の値を反映するために使用される。 CSS プロパティを反映するオブジェクトの場合、baseVal は プレゼンテーション属性を反映するために使用される。

この関係はライブであり、属性またはその反映されたプロパティのいずれかが変更された場合、 値を（反映された値の同期の規則に従って） 同期しなければならない。

属性が文書マークアップ内で明示的に指定されていない場合でも、 反映されるオブジェクトはアクセス時に 属性の初期値で初期化される。 属性の初期値が (none) の場合、 オブジェクトは 空の初期値の反映で定義されるように初期化される。 この新しく構築されたオブジェクトは、最初に変更されるまで要素上に 属性を生成しない。対応する 属性に加えられた変更は直ちにオブジェクトに反映される。

lineElement.x1.baseVal にアクセスし （ここで lineElement は SVGLineElement のインスタンスである）、 ‘x1’ 属性が文書内で指定されていなかった場合、 返される SVGLength オブジェクトは 値 0 ユーザー単位を表す。 これは属性の初期値が 0 であるためである。

4.3.5. 反映された値の同期

反映されたコンテンツ属性の基底値が変更されるたびに、 反映するオブジェクトは、値が変更された直後に次の手順を実行することによって 同期されなければならない。

1. 反映するオブジェクトがリストインターフェイスオブジェクトの場合、 リストインターフェイスオブジェクトを 同期する手順を実行する。
2. それ以外の場合、オブジェクトの値を、反映された コンテンツ属性の基底値に更新する（属性が 存在しないか無効な場合は、その属性の初期値を使用する）。

   例えば、これにより SVGLength オブジェクトの 値が更新される。

反映されたコンテンツ属性を、 任意で特定の値を使用して 再シリアライズする場合、 次の手順を実行しなければならない。

1. value を、指定された特定の値、または 特定の値が提供されていない場合はコンテンツ属性の反映する IDL 属性の 値とする。
2. value の型に応じて:

   SVGAnimatedBoolean

   SVGAnimatedNumber

   SVGAnimatedLength

   SVGAnimatedAngle

   SVGAnimatedRect

   SVGAnimatedString

   SVGAnimatedNumberList

   SVGAnimatedLengthList

   SVGAnimatedTransformList

   value の baseVal メンバーを使用して コンテンツ属性を再シリアライズする。

   SVGAnimatedEnumeration

   1. number を value の baseVal メンバーの値とする。
   2. keyword を、number に対応するコンテンツ属性のキーワード 値、または number が 0 の場合は空文字列とする。

      これは、列挙値が何らかの方法で 「unknown」値に設定された場合、コンテンツ属性が 空文字列に設定されることを意味する。 ただし、この unknown 値を SVGAnimatedEnumeration オブジェクトに直接設定することはできない。 これは、マークアップで設定された未知の属性値を表す。

   3. コンテンツ属性を keyword に設定する。

   boolean

   value が true の場合はコンテンツ属性を "true" に設定し、 それ以外の場合は "false" に設定する。

   float

   double

   コンテンツ属性を、 CSS 構文を使用して <number> として解析した場合、 実装がサポートする実数精度を前提として value に最も近い数値を返す、実装固有の文字列に設定する。

   SVGLength

   コンテンツ属性を、value の valueAsString メンバーを取得したときに返される値に設定する。

   SVGAngle

   コンテンツ属性を、value の valueAsString メンバーを取得したときに返される値に設定する。

   SVGRect

   1. components を、value の x、 y、 width および height メンバーの値である 4 つの値のリストとする。
   2. serialized components を 4 つの文字列のリストとする。 それぞれは、CSS 構文を使用して <number> として解析した場合、 実装がサポートする実数精度を前提として、 components 内の対応する値に最も近い数値を返す 実装固有の文字列である。
   3. コンテンツ属性を、 serialized components 内の文字列を単一の U+0020 SPACE 文字で結合して区切った文字列に設定する。

   DOMString

   コンテンツ属性を value に設定する。

   SVGNumberList

   SVGLengthList

   SVGPointList

   SVGTransformList

   SVGStringList

   1. elements を value 内の値のリストとする。

      値は value の型に応じて、 SVGNumber、SVGLength、 SVGPoint または SVGTransform オブジェクト、あるいは DOMString 値となる。

   2. serialized elements を文字列のリストとする。各 文字列は elements 内の対応する値と その型に基づいて次のように形成される。

      SVGNumber オブジェクト

      文字列は、CSS 構文を使用して <number> として解析した場合、 実装がサポートする実数 精度を前提として、 SVGNumber オブジェクトの value メンバーに最も近い 数値を返す実装固有の文字列である。

      SVGLength オブジェクト

      文字列は、その値の valueAsString メンバーを取得したときに返される値である。

      SVGPoint オブジェクト

      文字列値は次のように計算される。

      1. string を空文字列とする。
      2. x および y を、それぞれ SVGPoint オブジェクトの x 座標および y 座標の値とする。
      3. string に、CSS 構文を使用して <number> として解析した場合、実装がサポートする実数 精度を前提として x に最も近い数値を返す 実装固有の文字列を付加する。
      4. string に単一の U+002C COMMA 文字を付加する。
      5. string に、CSS 構文を使用して <number> として解析した場合、実装がサポートする実数 精度を前提として y に最も近い数値を返す 実装固有の文字列を付加する。
      6. 文字列は string とする。

      SVGTransform オブジェクト

      文字列は、SVGTransform オブジェクトの行列オブジェクトの シリアライズである。

      DOMString

      文字列は DOMString 自体の値である。

   3. コンテンツ属性を、 serialized elements 内の文字列を単一の U+0020 SPACE 文字で結合して区切った文字列に設定する。

4.3.6. 空の初期値の反映

null または空の初期値を反映する SVG DOM 属性を初期化する場合、 この節で定義されるように、 プロパティをそのデータ型に従って初期化しなければならない。 これは、反映されるコンテンツ属性に明示的な値がなく、 属性定義表の初期値が (none) の場合にのみ発生する。

インターフェイスが以下に列挙されていない場合、 オブジェクトの初期化は、そのインターフェイスが含む オブジェクトの値を使用して行わなければならない。例えば、 SVGAnimatedString は 2 つの DOMString メンバーで構成され、 SVGRect は 多数の double で構成される。

DOMString

空文字列（""）として初期化する。

float

long

short

WebIDL で定義されるその他の数値型

0 として初期化する。

boolean

false として初期化する。

SVGLength

0 ユーザー単位として初期化する （SVG_LENGTHTYPE_NUMBER）。

SVGLengthList

SVGNumberList

SVGPointList

SVGStringList

SVGTransformList

空リストとして初期化する。

SVGAngle

未指定単位の 0 として初期化する （SVG_ANGLETYPE_UNSPECIFIED）。

SVGPreserveAspectRatio

'xMidYMid meet' として初期化する。

textElement.dx.baseVal にアクセスし （ここで textElement は SVGTextElement のインスタンスである）、 ‘dx’ 属性が文書内で指定されていなかった場合、 返される SVGLengthList オブジェクトは 空になる。

4.3.7. 無効な値

スクリプトが反映された DOM 属性に、 コンテンツ属性にとっての無効な値（例えば、 非負の数値を必要とする属性に対する負の 数値）を設定した場合、 この仕様で別途示されていない限り、設定時に例外は 発生しないが、指定された文書フラグメントは エラー処理で説明されるように、 技術的にはエラー状態になる。

整数定数を使用して列挙値を反映する DOM 属性は例外である。 これらは、範囲外の整数、 または未知の属性値を表す定数 (0) に設定された場合、 TypeError をスローする。 これは WebIDL 列挙型の動作 [WebIDL] と一致する。

4.4. SVG 要素の DOM インターフェイス

[Exposed=Window]
interface SVGElement : Element {

  [SameObject] readonly attribute SVGAnimatedString className;

  readonly attribute SVGSVGElement? ownerSVGElement;
  readonly attribute SVGElement? viewportElement;
};

SVGElement includes GlobalEventHandlers;
SVGElement includes HTMLOrSVGOrMathMLElement;

dictionary SVGBoundingBoxOptions {
  boolean fill = true;
  boolean stroke = false;
  boolean markers = false;
  boolean clipped = false;
};

[Exposed=Window]
interface SVGGraphicsElement : SVGElement {
  [SameObject] readonly attribute SVGAnimatedTransformList transform;

  SVGRect getBBox(optional SVGBoundingBoxOptions options = {});
  SVGMatrix? getCTM();
  SVGMatrix? getScreenCTM();
};

SVGGraphicsElement includes SVGTests;

[Exposed=Window]
interface SVGGeometryElement : SVGGraphicsElement {
  [SameObject] readonly attribute SVGAnimatedNumber pathLength;

  boolean isPointInFill(optional DOMPointInit point = {});
  boolean isPointInStroke(optional DOMPointInit point = {});
  float getTotalLength();
  SVGPoint getPointAtLength(float distance);
};

4.5. 基本データ型の DOM インターフェイス

4.5.1. インターフェイス SVGNumber

SVGNumber インターフェイスは主として、 SVGNumberList の一部である <number> 値を表すために使用される。 個々の SVGNumber オブジェクトをスクリプトによって作成することもできる。

SVGNumber オブジェクトは読み取り専用として指定できる。 これは、以下で説明するように、オブジェクトを変更しようとすると例外が スローされることを意味する。 animVal IDL 属性を通じて反映される SVGNumber オブジェクトは常に 読み取り専用である。

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

SVGNumber オブジェクトは、 値と呼ばれる内部数値を 保持する。

[Exposed=Window]
interface SVGNumber {
  attribute float value;
};

value IDL 属性は 数値を表す。value を取得すると、 SVGNumber の値を返す。

value を設定すると、 次の手順を実行する。

1. SVGNumber が読み取り専用の場合、 NoModificationAllowedError を スローする。
2. SVGNumber の値を、 value メンバーに代入される値に設定する。
3. SVGNumber が、 反映された属性の 基底値の要素を反映する場合、 反映された属性を再シリアライズする。

4.5.2. インターフェイス SVGLength

SVGLength インターフェイスは、 <length>、<percentage>、または <number> 値になり得る値を表すために使用される。

SVGLength オブジェクトは読み取り専用として指定できる。 これは、以下で説明するように、オブジェクトを変更しようとすると例外が スローされることを意味する。 animVal IDL 属性を通じて反映される SVGLength オブジェクトは常に 読み取り専用である。

SVGLength オブジェクトは、特定の要素に関連付けることができ、さらに方向性として 水平、垂直、または未指定を指定できる。関連付けられた要素と長さの方向性は、 パーセント値をユーザー単位へ解決するために使用され、またオブジェクトが属性を反映する場合に どの要素のコンテンツ属性を更新するかを決定するためにも使用される。別途 説明されていない限り、SVGLength オブジェクトは どの要素にも関連付けられておらず、 方向性は未指定である。

SVGLength オブジェクトは、内部に <length>、 <percentage>、または <number> 値を保持し、これをその 値と呼ぶ。

[Exposed=Window]
interface SVGLength {

  // 長さの単位型
  const unsigned short SVG_LENGTHTYPE_UNKNOWN = 0;
  const unsigned short SVG_LENGTHTYPE_NUMBER = 1;
  const unsigned short SVG_LENGTHTYPE_PERCENTAGE = 2;
  const unsigned short SVG_LENGTHTYPE_EMS = 3;
  const unsigned short SVG_LENGTHTYPE_EXS = 4;
  const unsigned short SVG_LENGTHTYPE_PX = 5;
  const unsigned short SVG_LENGTHTYPE_CM = 6;
  const unsigned short SVG_LENGTHTYPE_MM = 7;
  const unsigned short SVG_LENGTHTYPE_IN = 8;
  const unsigned short SVG_LENGTHTYPE_PT = 9;
  const unsigned short SVG_LENGTHTYPE_PC = 10;

  readonly attribute unsigned short unitType;
           attribute float value;
           attribute float valueInSpecifiedUnits;
           attribute DOMString valueAsString;

  undefined newValueSpecifiedUnits(unsigned short unitType, float valueInSpecifiedUnits);
  undefined convertToSpecifiedUnits(unsigned short unitType);
};

SVGLength 上で定義される数値の長さ単位型定数は、 SVGLength の値の型を表すために使用される。 それぞれの意味は次のとおりである。

数値の長さ単位型定数を使用することはアンチパターンであり、 SVGLength がサポートする その他の単位または長さ型について新しい定数値が導入されることはない。他の種類の長さが サポートされ使用される場合、SVGLength は SVG_LENGTHTYPE_UNKNOWN 単位型を使用する。このような長さ型で SVGLength のその他のプロパティが どのように動作するかについては以下を参照。

unitType IDL 属性は、 SVGLength の値がどの型の値であるかを表す。 unitType を取得すると、 次の手順を実行する。

1. SVGLength の値が、単位なしの <number>、<percentage>、または em、 ex、 px、 cm、 mm、 in、 pt、もしくは pc 単位を持つ <length> である場合、 上記の長さ単位型表から対応する定数 値を返す。
2. それ以外の場合、 SVG_LENGTHTYPE_UNKNOWN を返す。

   例えば、ch 単位を持つ <length>、 または calc() のような非スカラー値の場合、 SVG_LENGTHTYPE_UNKNOWN が返される。

value IDL 属性は、 SVGLength の値をユーザー単位で表す。 value を取得すると、 次の手順を実行する。

1. value を SVGLength の値とする。
2. value が <number> の場合、 その数値を返す。
3. viewport size を、SVGLength の 関連付けられた要素および 方向性に基づき、 パーセント値を解決する基準とする。

   関連付けられた要素がない

   viewport size は 100

   関連付けられた要素があり、方向性が水平

   viewport size は関連付けられた 要素の SVG ビューポートの幅

   関連付けられた要素があり、方向性が垂直

   viewport size は関連付けられた要素の SVG ビューポートの高さ

   関連付けられた要素があり、方向性が未指定

   viewport size は関連付けられた要素の SVG ビューポートの 対角線の長さ（単位を参照）

4. font size を、SVGLength の関連付けられた要素に基づき、 フォントサイズ値を解決する基準とする。

   関連付けられた要素がない

   font size は font-size プロパティの初期値の絶対長

   関連付けられた要素がある

   font size は関連付けられた要素の font-size プロパティの計算値

5. viewport size および font size を、それぞれパーセント値およびフォントサイズの 基準として使用し、value を絶対長へ変換した結果を返す。 関連付けられた要素が ないため変換できない場合は、0 を返す。

value を設定すると、 次の手順を実行する。

1. SVGLength オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. value を value に代入される値とする。
3. SVGLength の値を、値が value である <number> に設定する。
4. SVGLength が、 反映された属性の 基底値を反映する、 プレゼンテーション属性を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

valueInSpecifiedUnits IDL 属性は、 SVGLength の値の数値係数を表す。 valueInSpecifiedUnits を取得すると、次の 手順を 実行する。

1. value を SVGLength の値とする。
2. value が <number> の場合、 その数値を返す。
3. それ以外の場合、value が <percentage> またはスカラーの <length> 値である場合、その単位の前の数値係数を返す。
4. それ以外の場合、0 を返す。

   したがって valueInSpecifiedUnits は '12%' と 12em の両方について 12 を返すが、 calc(12px + 5%) のような非スカラー値については 0 が返される。

valueInSpecifiedUnits を設定すると、次の 手順を 実行する。

1. SVGLength オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. value を valueInSpecifiedUnits に代入される値とする。
3. SVGLength の値が <number> の場合、その値を value に更新する。
4. それ以外の場合、SVGLength の値が <percentage> またはスカラー値の <length> である場合、 その数値係数を value に更新する。
5. それ以外の場合、SVGLength の値は その他の型である。その値を value である <number> に設定する。
6. SVGLength が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

valueAsString IDL 属性は、 SVGLength の値を文字列として表す。 valueAsString を取得すると、 次の手順を実行する。

1. value を SVGLength の値とする。
2. string を空文字列とする。
3. value が <number>、<percentage> またはスカラーの <length> 値である場合:
   1. factor を、value が <percentage> または <length> の場合は value の数値係数、 <number> の場合は value 自体とする。
   2. string に、CSS 構文を使用して <number> として解析した場合、 実装がサポートする実数精度を前提として factor に最も近い数値を返す 実装固有の文字列を付加する。
   3. value が <percentage> の場合、 string に単一の U+0025 PERCENT SIGN 文字を付加する。
   4. それ以外の場合、value が <length> である場合、 string に value の単位の正準表記を付加する。
   5. string を返す。
4. それ以外の場合、<length> として解析した場合に、 実装がサポートする実数精度を前提として value に最も近い 長さ値を返す実装固有の文字列を返す。

valueAsString を設定すると、 次の手順を実行する。

1. SVGLength オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. value を valueAsString に代入される値とする。
3. CSS 構文 [ <number> | <length> | <percentage> ] を使用して value を解析する。
4. 解析に失敗した場合、 SyntaxError を スローする。
5. それ以外の場合、解析は成功した。 SVGLength の値を 解析された値に設定する。
6. SVGLength が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

newValueSpecifiedUnits メソッドは、SVGLength の値を 型付きの方法で設定するために使用される。 newValueSpecifiedUnits(unitType, valueInSpecifiedUnits) が呼び出されると、 次の手順を実行する。

1. SVGLength オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. unitType が SVG_LENGTHTYPE_UNKNOWN であるか、上記の長さ単位型表に現れない値である場合、 NotSupportedError を スローする。
3. unitType の値に応じて SVGLength の値を設定する。

   SVG_LENGTHTYPE_NUMBER

   値が valueInSpecifiedUnits である <number>

   SVG_LENGTHTYPE_PERCENTAGE

   数値係数が valueInSpecifiedUnits である <percentage>

   その他すべて

   数値係数が valueInSpecifiedUnits であり、 単位が上記の長さ単位型表で示される <length>

4. SVGLength が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

convertToSpecifiedUnits メソッドは、SVGLength の値を 特定の型へ変換するために使用される。 convertToSpecifiedUnits(unitType) が呼び出されると、次の手順を実行する。

1. SVGLength オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. unitType が SVG_LENGTHTYPE_UNKNOWN であるか、上記の長さ単位型表に現れない値である場合、 NotSupportedError を スローする。
3. absolute を value メンバーから返される値とする。
4. unitType が SVG_LENGTHTYPE_NUMBER の場合:
   1. SVGLength の値を、 値が absolute である <number> に設定する。
5. それ以外の場合、unitType が SVG_LENGTHTYPE_PERCENTAGE の場合:
   1. viewport size を、SVGLength の 関連付けられた要素および 方向性に基づき、 パーセント値を解決する基準とする。

      関連付けられた要素がない

      viewport size は 100

      関連付けられた要素があり、方向性が水平

      viewport size は関連付けられた要素の SVG ビューポートの幅

      関連付けられた要素があり、方向性が垂直

      viewport size は関連付けられた要素の SVG ビューポートの高さ

      関連付けられた要素があり、方向性が未指定 方向性

      viewport size は関連付けられた要素の SVG ビューポートの 対角線の長さ（単位を参照）

   2. viewport size を パーセント基準として使用し、absolute を <percentage> に変換した結果に SVGLength の値を設定する。
6. それ以外の場合、unitType が SVG_LENGTHTYPE_EMS または SVG_LENGTHTYPE_EXS の場合:
   1. font size を、SVGLength の関連付けられた要素に基づき、 フォントサイズ値を解決する基準とする。

      関連付けられた要素がない

      font size は font-size プロパティの初期値の絶対長

      関連付けられた要素がある

      font size は関連付けられた要素の font-size プロパティの計算値

   2. font size を font-size の基準として使用し、 absolute を unitType に応じて em または ex 単位を持つ <length> に変換した結果に、 SVGLength の値を設定する。
7. それ以外の場合:
   1. 上記の長さ単位型表で unitType を検索して得られる単位を持つ <length> に absolute を変換した結果に、 SVGLength の値を設定する。
8. SVGLength が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

4.5.3. インターフェイス SVGAngle

SVGAngle インターフェイスは、 <angle> または <number> 値になり得る 値を表すために使用される。

SVGAngle オブジェクトは読み取り専用として指定できる。 これは、以下で説明するように、オブジェクトを変更しようとすると例外が スローされることを意味する。animVal 属性を通じて反映される SVGAngle は常に 読み取り専用である。

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

SVGAngle オブジェクトは、 <angle> または <number> の内部値を保持し、これを 値と呼ぶ。

[Exposed=Window]
interface SVGAngle {

  // 角度の単位型
  const unsigned short SVG_ANGLETYPE_UNKNOWN = 0;
  const unsigned short SVG_ANGLETYPE_UNSPECIFIED = 1;
  const unsigned short SVG_ANGLETYPE_DEG = 2;
  const unsigned short SVG_ANGLETYPE_RAD = 3;
  const unsigned short SVG_ANGLETYPE_GRAD = 4;

  readonly attribute unsigned short unitType;
           attribute float value;
           attribute float valueInSpecifiedUnits;
           attribute DOMString valueAsString;

  undefined newValueSpecifiedUnits(unsigned short unitType, float valueInSpecifiedUnits);
  undefined convertToSpecifiedUnits(unsigned short unitType);
};

SVGAngle 上で定義される数値の角度単位型定数は、 SVGAngle の値の型を表すために使用される。 それぞれの意味は次のとおりである。

数値の角度単位型定数を使用することはアンチパターンであり、 SVGAngle がサポートする その他の単位または角度型について新しい定数値が導入されることはない。他の種類の角度がサポートされ 使用される場合、SVGAngle は SVG_ANGLETYPE_UNKNOWN 単位型を使用する。このような角度型で SVGAngle のその他のプロパティが どのように動作するかについては以下を参照。

unitType IDL 属性は、 SVGAngle の値がどの型の値であるかを表す。 unitType を取得すると、 次の手順を実行する。

1. SVGAngle の値が単位なしの <number>、または deg、 rad、もしくは grad 単位を持つ <angle> である場合、 上記の角度単位型表から対応する定数 値を返す。
2. それ以外の場合、 SVG_ANGLETYPE_UNKNOWN を返す。

   例えば、turn 単位を持つ <angle> の場合、 SVG_ANGLETYPE_UNKNOWN が返される。

value IDL 属性は、 SVGAngle の値を度単位で表す。 value を取得すると、 次の手順を実行する。

1. value を SVGAngle の値とする。
2. value が <number> の場合、 その数値を返す。
3. value を度単位の角度へ変換した結果を返す。

value を設定すると、 次の手順を実行する。

1. SVGAngle オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. value を value に代入される値とする。
3. SVGAngle の値を、 値が value である <number> に設定する。
4. SVGAngle が 反映された属性の 基底値を反映する場合、 反映された属性を再シリアライズする。

valueInSpecifiedUnits IDL 属性は、 SVGAngle の値の数値係数を表す。 valueInSpecifiedUnits を取得すると、次の 手順を 実行する。

1. value を SVGAngle の値とする。
2. value が <number> の場合、 その数値を返す。
3. それ以外の場合、value は <angle> 値である。その単位の前の 数値係数を返す。

valueInSpecifiedUnits を設定すると、次の 手順を 実行する。

1. SVGAngle オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. value を valueInSpecifiedUnits に代入される値とする。
3. SVGAngle の値が <number> の場合、その値を value に更新する。
4. それ以外の場合、SVGAngle の値が <angle> である場合、 その数値係数を value に更新する。
5. SVGAngle が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

valueAsString IDL 属性は、 SVGAngle の値を文字列として表す。 valueAsString を取得すると、 次の手順を実行する。

1. value を SVGAngle の値とする。
2. string を空文字列とする。
3. factor を、value が <angle> の場合は value の数値係数、 <number> の場合は value 自体とする。
4. string に、CSS 構文を使用して <number> として解析した場合、 実装がサポートする実数精度を前提として factor に最も近い数値を返す 実装固有の文字列を付加する。
5. value が <angle> の場合、 string に value の単位の正準表記を付加する。
6. string を返す。

valueAsString を設定すると、 次の手順を実行する。

1. SVGAngle オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. value を valueAsString に代入される値とする。
3. CSS 構文 [ <number> | <angle> ] を使用して value を解析する。
4. 解析に失敗した場合、 SyntaxError を スローする。
5. それ以外の場合、解析は成功した。 SVGAngle の 値を 解析された値に設定する。
6. SVGAngle が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

newValueSpecifiedUnits メソッドは、SVGAngle の値を 型付きの方法で設定するために使用される。 newValueSpecifiedUnits(unitType, valueInSpecifiedUnits) が呼び出されると、 次の手順を実行する。

1. SVGAngle オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. unitType が SVG_ANGLETYPE_UNKNOWN であるか、上記の角度単位型表に現れない値である場合、 NotSupportedError を スローする。
3. unitType の値に応じて SVGAngle の値を設定する。

   SVG_ANGLETYPE_UNSPECIFIED

   値が valueInSpecifiedUnits である <number>

   その他すべて

   数値係数が valueInSpecifiedUnits であり、 単位が上記の角度単位型表で示される <angle>

4. SVGAngle が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

convertToSpecifiedUnits メソッドは、SVGAngle の値を 特定の型へ変換するために使用される。 convertToSpecifiedUnits(unitType) が呼び出されると、次の手順を実行する。

1. SVGAngle オブジェクトが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. unitType が SVG_ANGLETYPE_UNKNOWN であるか、上記の角度単位型表に現れない値である場合、 NotSupportedError を スローする。
3. degrees を value メンバーから返される値とする。
4. unitType が SVG_ANGLETYPE_UNSPECIFIED の場合:
   1. SVGAngle の値を、 値が degrees である <number> に設定する。
5. それ以外の場合:
   1. 上記の角度単位型表で unitType を検索して得られる単位を持つ <angle> に degrees を変換した結果に、 SVGAngle の値を設定する。
6. SVGAngle が 反映された属性の 基底値を反映する、または 反映された属性の基底値の要素を反映する場合、 反映された属性を再シリアライズする。

4.5.4. リストインターフェイス

一部の SVG 属性は値のリストを含む。これらの値を表すため、 必要な要素型ごとに 1 つずつ、いくつかの SVG DOM リスト インターフェイスがある。すなわち、SVGNumberList、SVGLengthList、 SVGPointList、SVGTransformList、および SVGStringList である。 最初の 4 つは、 SVGAnimatedNumberList、SVGAnimatedLengthList、 SVGAnimatedPoints、および SVGTransformList オブジェクトの 基底コンポーネントとアニメーションコンポーネントを表すために使用される。 5 番目の SVGStringList は、 文字列のリストを取る少数の非アニメーション属性を 反映するために使用される。

ほとんどのリストインターフェイスは次の形式を取る。

interface SVGNameList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  Type initialize(Type newItem);
  getter Type getItem(unsigned long index);
  Type insertItemBefore(Type newItem, unsigned long index);
  Type replaceItem(Type newItem, unsigned long index);
  Type removeItem(unsigned long index);
  Type appendItem(Type newItem);
  setter undefined (unsigned long index, Type newItem);
};

ここで Name はリスト要素の説明的な名前 （"Number"、"Length"、"Point"、"Transform" または "String"）であり、Type は リスト要素の IDL 型（SVGNumber、SVGLength、SVGPoint、SVGTransform または DOMString）である。

SVGTransformList インターフェイスは 上記の形式を取るが、 さらに 2 つのメソッドを持つ。

SVGTransformList を除く すべてのリストインターフェイスオブジェクトは、 反映されたコンテンツ属性の基底値を反映する。 SVGTransformList オブジェクトは、 プレゼンテーション属性 （‘transform’、 ‘gradientTransform’ または ‘patternTransform’）を反映する。 すべてのリストインターフェイスオブジェクトは特定の要素に関連付けられる。 SVGLength および類似のオブジェクトとは異なり、 「切り離された」 リストインターフェイスオブジェクトは存在しない。

リストインターフェイスオブジェクトは内部に要素のリストを保持し、 以下の本文では単に「リスト」と呼ぶ。 IDL 属性およびメソッドは、リストの要素を調査および操作するために使用される。 リストは、反映されたコンテンツ属性の変更や コンテンツ属性のアニメーション（または SVGTransformList オブジェクトの場合は、 transform プロパティの計算値の変更）に応じて変更されることもある。

リスト インターフェイスオブジェクトは 読み取り専用として指定できる。これは、以下で説明するように、 オブジェクトを変更しようとすると例外がスローされることを意味する。 animVal IDL 属性を通じて反映されるリストインターフェイス オブジェクトは常に読み取り専用である。

リストインターフェイスオブジェクトは、 次の手順を実行することによって 同期される。

1. value を 反映されたコンテンツ属性の基底値とする。属性が存在しない場合、またはその 値を解析できない場合、value を属性の 初期値、または属性の 初期値が (none) の場合は空リストとする。
2. length をリスト内の項目数とする。
3. new length を value 内の値の数とする。 value がキーワード none （transform プロパティでサポートされる）である場合、 new length は 0 とする。
4. リスト要素型が SVGNumber、SVGLength、SVGPoint または SVGTransform の場合:
   1. length > new length の場合:
      1. リスト内でインデックスが new length 以上の各オブジェクトを 切り離す。
      2. リストを長さ new length に切り詰める。
      3. length を new length に設定する。
   2. length < new length の間:
      1. item を、リスト要素型の 新しく作成されたオブジェクトとする。
      2. item をこのリストインターフェイス オブジェクトに取り付ける。
      3. item をリストに付加する。
      4. length を length + 1 に設定する。
   3. index を 0 とする。
   4. index < length の間:
      1. item を、リスト内のインデックス index にあるオブジェクトとする。
      2. v を、value 内のインデックス index にある値とする。
      3. item の値を v に設定する。
      4. item が SVGTransform オブジェクトの場合、 その行列オブジェクトの成分を 新しい変換関数値に一致するよう設定する。
      5. index を index + 1 に設定する。
5. それ以外の場合、リスト要素型は DOMString である。
   1. リストを、value 内の値から構成される 新しいリストで置き換える。

リスト要素オブジェクトを切り離す場合は常に、 リスト要素型に応じて次の手順を実行する。

SVGNumber

SVGNumber を、どの要素にも 関連付けられていない状態に設定する。 SVGNumber が読み取り専用の場合、 読み取り専用でない状態に設定する。

SVGLength

SVGLength を、どの要素にも 関連付けられていない状態に設定する。 SVGLength が読み取り専用の場合、 読み取り専用でない状態に設定する。SVGLength の 方向性を未指定に設定する。

SVGPoint

SVGPoint を、どの要素にも 関連付けられていない状態に設定する。 SVGPoint が読み取り専用の場合、 読み取り専用でない状態に設定する。

SVGTransform

SVGTransform を、どの要素にも 関連付けられていない状態に設定する。 SVGTransform が読み取り専用の場合、 読み取り専用でない状態に設定する。

DOMString

何もしない。

リスト要素オブジェクトを取り付ける場合は常に、 リスト要素型に応じて次の手順を実行する。

リストインターフェイスオブジェクトの サポートされるプロパティインデックスは、 リストの長さ未満のすべての非負整数の集合である。

length および numberOfItems IDL 属性は リストの長さを表し、取得時には単に リストの長さを返す。

clear メソッドは、 リスト内のすべての項目を削除するために使用される。clear() が呼び出されると、次の手順を実行する。

1. リストが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. リスト内のすべての要素を切り離し、その後削除する。
3. リストが属性を反映する場合、または属性を反映するオブジェクトの 基底値を表す場合、反映された属性を 再シリアライズする。

initialize メソッドは、 リストをクリアし、指定された単一の値を追加するために使用される。 initialize(newItem) が呼び出されると、次の手順を実行する。

1. リストが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. リスト内のすべての要素を切り離し、その後削除する。
3. newItem がオブジェクト型であり、newItem が 切り離されたオブジェクトではない場合、newItem を、 newItem と同じ型で、 同じ（数値または長さ）値を持つ新しく作成されたオブジェクトに設定する。
4. newItem をリスト インターフェイスオブジェクトに取り付ける。
5. newItem をこのリストに付加する。
6. リストが属性を反映する場合、または属性を反映するオブジェクトの 基底値を表す場合、反映された属性を 再シリアライズする。
7. newItem を返す。

getItem メソッドは、 リスト内の指定された位置から項目を取得するために使用される。 getItem(index) が呼び出されると、次の手順を実行する。

1. index がリストの長さ以上の場合、 IndexSizeError を スローする。
2. リスト内の位置 index にある要素を返す。

   リストの要素型が SVGLength などのオブジェクト型の場合、 そのオブジェクトのコピーではなく、 そのオブジェクトへの参照が返されることに注意すること。

insertItemBefore メソッドは、リスト内の特定の位置に要素を挿入するために使用される。 insertItemBefore(newItem, index) が呼び出されると、 次の手順を実行する。

1. リストが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. newItem がオブジェクト型であり、newItem が 切り離されたオブジェクトではない場合、newItem を、 newItem と同じ型で、 同じ（数値または長さ）値を持つ新しく作成されたオブジェクトに設定する。
3. index がリストの長さより大きい場合、 index をリストの長さに設定する。
4. newItem をリストのインデックス index に挿入する。
5. newItem をリストインターフェイスオブジェクトに取り付ける。
6. リストが属性を反映する場合、または属性を反映するオブジェクトの 基底値を表す場合、反映された属性を 再シリアライズする。
7. newItem を返す。

replaceItem メソッドは、 リスト内の既存の項目を新しい項目で置き換えるために使用される。 replaceItem(newItem, index) が呼び出されると、 次の手順を実行する。

1. リストが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. index がリストの長さ以上の場合、 IndexSizeError を スローする。
3. newItem がオブジェクト型であり、newItem が 切り離されたオブジェクトではない場合、newItem を、 newItem と同じ型で、 同じ（数値または長さ）値を持つ新しく作成されたオブジェクトに設定する。
4. リスト内のインデックス index にある要素を切り離す。
5. リスト内のインデックス index にある要素を newItem で置き換える。
6. newItem をリスト インターフェイスオブジェクトに取り付ける。
7. リストが属性を反映する場合、または属性を反映するオブジェクトの 基底値を表す場合、反映された属性を 再シリアライズする。
8. newItem を返す。

removeItem メソッドは、 リストから項目を削除するために使用される。removeItem(index) が呼び出されると、次の手順を実行する。

1. リストが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. index がリストの長さ以上の場合、 IndexSizeError をコード付きで スローする。
3. item を、リストのインデックス index にある要素とする。
4. item を切り離す。
5. リスト内のインデックス index にある要素を削除する。
6. item を返す。

appendItem メソッドは、 リストの末尾に項目を付加するために使用される。appendItem(newItem) が呼び出されると、次の手順を実行する。

1. リストが読み取り専用の場合、 NoModificationAllowedError を スローする。
2. newItem がオブジェクト型であり、newItem が 切り離されたオブジェクトではない場合、newItem を、 newItem と同じ型で、 同じ（数値または長さ）値を持つ新しく作成されたオブジェクトに設定する。
3. index をリストの長さとする。
4. newItem をリストの末尾に付加する。
5. newItem をリスト インターフェイスオブジェクトに取り付ける。
6. リストが属性を反映する場合、または属性を反映するオブジェクトの 基底値を表す場合、反映された属性を 再シリアライズする。
7. newItem を返す。

インデックス付きプロパティセッターの動作は、 replaceItem メソッドの動作と同じである。

4.5.5. インターフェイス SVGNumberList

SVGNumberList インターフェイスは、 要素が SVGNumber オブジェクトである リストインターフェイスである。 SVGNumberList オブジェクトは 数値のリストを表す。

[Exposed=Window]
interface SVGNumberList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  SVGNumber initialize(SVGNumber newItem);
  getter SVGNumber getItem(unsigned long index);
  SVGNumber insertItemBefore(SVGNumber newItem, unsigned long index);
  SVGNumber replaceItem(SVGNumber newItem, unsigned long index);
  SVGNumber removeItem(unsigned long index);
  SVGNumber appendItem(SVGNumber newItem);
  setter undefined (unsigned long index, SVGNumber newItem);
};

SVGNumberList のすべてのインターフェイスメンバーの動作は、 上記のリストインターフェイスの節で 定義されている。

4.5.6. インターフェイス SVGLengthList

SVGLengthList インターフェイスは、 要素が SVGLength オブジェクトである リストインターフェイスである。 SVGLengthList オブジェクトは 長さのリストを表す。

[Exposed=Window]
interface SVGLengthList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  SVGLength initialize(SVGLength newItem);
  getter SVGLength getItem(unsigned long index);
  SVGLength insertItemBefore(SVGLength newItem, unsigned long index);
  SVGLength replaceItem(SVGLength newItem, unsigned long index);
  SVGLength removeItem(unsigned long index);
  SVGLength appendItem(SVGLength newItem);
  setter undefined (unsigned long index, SVGLength newItem);
};

SVGLengthList のすべてのインターフェイスメンバーの動作は、 上記のリストインターフェイスの節で 定義されている。

4.5.7. インターフェイス SVGStringList

SVGStringList インターフェイスは、 要素が DOMString 値である リストインターフェイスである。 SVGStringList オブジェクトは 文字列のリストを表す。

[Exposed=Window]
interface SVGStringList {

  readonly attribute unsigned long length;
  readonly attribute unsigned long numberOfItems;

  undefined clear();
  DOMString initialize(DOMString newItem);
  getter DOMString getItem(unsigned long index);
  DOMString insertItemBefore(DOMString newItem, unsigned long index);
  DOMString replaceItem(DOMString newItem, unsigned long index);
  DOMString removeItem(unsigned long index);
  DOMString appendItem(DOMString newItem);
  setter undefined (unsigned long index, DOMString newItem);
};

SVGStringList のすべてのインターフェイスメンバーの動作は、 上記のリストインターフェイスの節で 定義されている。

4.6. アニメーション可能な SVG 属性を反映する DOM インターフェイス

次のインターフェイスは、アニメーション可能なコンテンツ属性の 反映された値を表すために使用される。 それぞれが同じデータを表す 2 つのコンポーネントオブジェクト、 baseVal および animVal で構成される。 baseVal（基底値）オブジェクトは変更可能であり、 対応する属性値を更新できる。

SVG 1.1 では、SVG DOM インターフェイスの animVal 属性は、 反映された属性の現在のアニメーション値を表していた。このバージョンの SVG では、 animVal は現在のアニメーション値を表さなくなり、代わりに baseVal の別名となる。

4.6.1. インターフェイス SVGAnimatedBoolean

SVGAnimatedBoolean オブジェクトは、 boolean 値を取るアニメーション可能な属性を 反映するために使用される。

[Exposed=Window]
interface SVGAnimatedBoolean {
           attribute boolean baseVal;
  readonly attribute boolean animVal;
};

baseVal および animVal IDL 属性は、 どちらも反映された属性の現在の非アニメーション値を表す。 baseVal または animVal を取得すると、 次の手順を実行する。

1. value を反映された属性の値、 または存在しない場合は空文字列とする。
2. value が "true" または "false" でない場合、value を 反映された属性の初期値に設定する。
3. value が "true" の場合は true を返し、それ以外の場合は false を返す。

baseVal を設定すると、 値が true の場合は反映された属性を "true" に設定し、それ以外の場合は "false" に 設定する。

4.6.2. インターフェイス SVGAnimatedEnumeration

SVGAnimatedEnumeration オブジェクトは、 キーワード値を取るアニメーション可能な属性（例えば ‘textPath’ 上の ‘method’ 属性）を反映するため、または アニメーション可能な属性が持つ値の型を反映するため （これは ‘marker’ 要素の ‘orient’ 属性に対する orientType IDL 属性でのみ行われる）に使用される。

[Exposed=Window]
interface SVGAnimatedEnumeration {
           attribute unsigned short baseVal;
  readonly attribute unsigned short animVal;
};

キーワード値のみを取る アニメーション可能な属性を反映する SVGAnimatedEnumeration オブジェクトでは、 baseVal および animVal IDL 属性は、 反映された属性の現在の非アニメーション値を表す。 orientType の場合、 これらは反映された ‘orient’ 属性の現在の非アニメーション値の型を表す。 baseVal または animVal を取得すると、 次の手順を実行する。

1. value を反映された属性の値 （存在しないか無効な場合は属性の初期値を使用する）とする。
2. 反映する IDL 属性の定義に従って、 value の数値型 値を返す。

baseVal を設定すると、 次の手順を実行する。

1. value を baseVal に代入される値とする。
2. value が 0 であるか、反映された属性のいずれの値に対する 数値型値でもない場合、 TypeError をスローする。
3. それ以外の場合、反映する IDL 属性が orientType であり、value が SVG_MARKER_ORIENT_ANGLE の場合、 反映された属性を文字列 "0" に設定する。
4. それ以外の場合、value は反映された属性の 特定の単一キーワード値に対する数値型値である。 反映された属性をその値に設定する。

4.6.3. インターフェイス SVGAnimatedInteger

SVGAnimatedInteger オブジェクトは、 整数値を取るアニメーション可能な属性（例えば ‘feTurbulence’ 上の ‘numOctaves’）を 反映するために使用される。 また、整数の後に任意の第 2 の整数を取る アニメーション可能な属性（例えば ‘feConvolveMatrix’ 上の ‘order’）の 一部分を反映するためにも使用される。

この SVGAnimatedInteger インターフェイスは この仕様では使用されないが、 Filter Effects 仕様では多数使用されている。

[Exposed=Window]
interface SVGAnimatedInteger {
           attribute long baseVal;
  readonly attribute long animVal;
};

単一の整数値を取る アニメーション可能な属性を反映する SVGAnimatedInteger オブジェクトでは、 baseVal および animVal IDL 属性は、 反映された属性の現在の非アニメーション値を表す。 整数の後に任意の第 2 の整数を取る属性の 1 つの整数を反映するものについては、2 つの整数の一方の 現在の非アニメーション値を表す。 baseVal または animVal を取得すると、 次の手順を実行する。

1. value を反映された属性の値 （存在しないか無効な場合は属性の初期値を使用する）とする。
2. 反映された属性が整数の後に任意の第 2 の 整数を取るよう定義されている場合:
   1. この SVGAnimatedInteger オブジェクトが 最初の整数を反映する場合、value 内の最初の値を返す。
   2. それ以外の場合、この SVGAnimatedInteger オブジェクトは 第 2 の整数を反映する。value 内の第 2 の値が明示的に 指定されている場合はその値を返し、そうでない場合は属性定義で 説明される暗黙の値を返す。

      例えば、‘order’ の定義では、暗黙の第 2 の整数は明示的な 最初の整数と同じであるとされている。

3. それ以外の場合、反映された属性は単一の 整数値を取るよう定義されている。value を返す。

baseVal を設定すると、 次の手順を実行する。

1. value を baseVal に代入される値とする。
2. new を整数のリストとする。
3. 反映された属性が整数の後に任意の第 2 の 整数を取るよう定義されている場合:
   1. current を反映された属性の値 （存在しないか無効な場合は属性の初期値を使用する）とする。
   2. first を current 内の最初の整数とする。
   3. second を、current 内の第 2 の整数が 明示的に指定されている場合はその値、そうでない場合は属性定義で 説明される暗黙の値とする。
   4. この SVGAnimatedInteger オブジェクトが 最初の整数を反映する場合、first を value に設定する。 それ以外の場合、second を value に設定する。
   5. first を new に付加する。
   6. second を new に付加する。
4. それ以外の場合、反映された属性は単一の 整数値を取るよう定義されている。value を new に付加する。
5. コンテンツ属性を、new 内の各整数を、 CSS 構文を使用して <number> として解析した場合に その整数を返す実装固有の文字列にシリアライズし、 単一の U+0020 SPACE 文字で結合して区切った文字列に設定する。

4.6.4. インターフェイス SVGAnimatedNumber

SVGAnimatedNumber オブジェクトは、 数値を取るアニメーション可能な属性（例えば ‘path’ 上の ‘pathLength’）を 反映するために使用される。また、 数値の後に任意の第 2 の数値を取る アニメーション可能な属性（例えば ‘feDiffuseLighting’ 上の ‘kernelUnitLength’）の 一部分を反映するためにも使用される。

[Exposed=Window]
interface SVGAnimatedNumber {
           attribute float baseVal;
  readonly attribute float animVal;
};

単一の数値を取る アニメーション可能な属性を反映する SVGAnimatedNumber オブジェクトでは、 baseVal および animVal IDL 属性は、 反映された属性の現在の非アニメーション値を表す。 数値の後に任意の第 2 の数値を取る属性の 1 つの数値を反映するものについては、2 つの数値の一方の 現在の非アニメーション値を表す。 baseVal または animVal を取得すると、 次の手順を実行する。

1. value を反映された属性の値 （存在しないか無効な場合は属性の初期値を使用する）とする。
2. 反映された属性が数値の後に任意の第 2 の 数値を取るよう定義されている場合:
   1. この SVGAnimatedNumber オブジェクトが 最初の数値を反映する場合、value 内の最初の値を返す。
   2. それ以外の場合、この SVGAnimatedNumber オブジェクトは 第 2 の数値を反映する。value 内の第 2 の値が明示的に 指定されている場合はその値を返し、そうでない場合は属性定義で 説明される暗黙の値を返す。

      例えば、‘kernelUnitLength’ の定義では、暗黙の第 2 の数値は明示的な 最初の数値と同じであるとされている。

3. それ以外の場合、反映された属性は単一の 数値を取るよう定義されている。value を返す。

baseVal を設定すると、 次の手順を実行する。

1. value を baseVal に代入される値とする。
2. new を数値のリストとする。
3. 反映された属性が数値の後に任意の第 2 の 数値を取るよう定義されている場合:
   1. current を反映された属性の値 （存在しないか無効な場合は属性の初期値を使用する）とする。
   2. first を current 内の最初の数値とする。
   3. second を、current 内の第 2 の数値が 明示的に指定されている場合はその値、そうでない場合は属性定義で 説明される暗黙の値とする。
   4. この SVGAnimatedNumber オブジェクトが 最初の数値を反映する場合、first を value に設定する。 それ以外の場合、second を value に設定する。
   5. first を new に付加する。
   6. second を new に付加する。
4. それ以外の場合、反映された属性は単一の 数値を取るよう定義されている。value を new に付加する。
5. コンテンツ属性を、new 内の各数値を、 CSS 構文を使用して <number> として解析した場合に、 実装がサポートする実数精度を前提として その数値に最も近い 値を返す実装固有の文字列にシリアライズし、 単一の U+0020 SPACE 文字で結合して区切った文字列に設定する。

4.6.5. インターフェイス SVGAnimatedLength

SVGAnimatedLength オブジェクトは、 (a) <length>、 <percentage> または <number> 値を取るアニメーション可能な属性、 または (b) これらの値のいずれかを取る CSS プロパティと、それに対応する プレゼンテーション属性を 反映するために使用される。

[Exposed=Window]
interface SVGAnimatedLength {
  [SameObject] readonly attribute SVGLength baseVal;
  [SameObject] readonly attribute SVGLength animVal;
};

baseVal および animVal IDL 属性は、 反映されたコンテンツ属性の現在の値を表す。 baseVal または animVal を取得すると、 次の条件を満たす SVGLength オブジェクトを返す。

• 反映された属性の基底値を反映するか、 指定された プレゼンテーション属性を反映する。
• SVGAnimatedLength 型の反映する IDL 属性を持つ オブジェクトを取得した SVG 要素に 関連付けられる。
• 具体的な反映された属性によって定義される 方向性を持つ。

4.6.6. インターフェイス SVGAnimatedAngle

SVGAnimatedAngle オブジェクトは、 orientAngle IDL 属性を通じて、 ‘marker’ 上のアニメーション可能な ‘orient’ 属性の <angle> 値を 反映するために使用される。

[Exposed=Window]
interface SVGAnimatedAngle {
  [SameObject] readonly attribute SVGAngle baseVal;
  [SameObject] readonly attribute SVGAngle animVal;
};

baseVal および animVal IDL 属性は、 反映された ‘orient’ 属性の現在の非アニメーションの <angle> 値を表す。 baseVal または animVal を取得すると、 次の条件を満たす SVGAngle オブジェクトを返す。

• 反映された ‘orient’ 属性の基底値を反映する。
• SVGAnimatedAngle 型の反映する IDL 属性を持つ オブジェクトを取得した SVG ‘marker’ 要素に関連付けられる。

4.6.7. インターフェイス SVGAnimatedString

SVGAnimatedString オブジェクトは、 文字列値を取るアニメーション可能な属性を 反映するために使用される。任意で、 第 2 の非推奨属性も追加で反映するよう定義できる。

[Exposed=Window]
interface SVGAnimatedString {
           attribute (DOMString or TrustedScriptURL) baseVal;
  readonly attribute DOMString animVal;
};

baseVal および animVal IDL 属性は、 反映された属性の現在の非アニメーション値を表す。 baseVal または animVal を取得すると、 次の手順を実行する。

1. 反映された属性が存在しない場合:
   1. SVGAnimatedString オブジェクトが第 2 の非推奨属性も追加で 反映するよう定義され、その属性が存在する場合、 その値を返す。
   2. それ以外の場合、反映された属性に初期 値がある場合、 それを返す。
   3. それ以外の場合、空文字列を返す。
2. それ以外の場合、反映された属性は存在する。その値を返す。

SVGURIReference インターフェイス上の href メンバーの場合、 ‘href’ 属性が存在せず、 非推奨の ‘xlink:href’ 属性が 存在する場合はその値が返され、 その他すべての場合は ‘href’ 属性が 返される。

baseVal を設定すると、 次の手順を実行する。

1. 反映された属性の要素が SVGScriptElement である場合、 value を、TrustedScriptURL、 反映された属性の Document の関連するグローバルオブジェクト、'SVGScriptElement href'、および 'script' を指定して Get Trusted Type compliant string アルゴリズムを実行した結果とする。
2. それ以外の場合、value を指定された値とする。
3. 反映された属性が存在せず、 SVGAnimatedString オブジェクトが 第 2 の非推奨属性も追加で反映するよう定義され、 その非推奨属性が存在する場合、 その非推奨属性を value に設定する。
4. それ以外の場合、反映された属性を value に設定する。

SVG には、まだ完全なスクリプト処理モデルがない。 Trusted Types は、属性および テキスト本体の変更保護が HTML スクリプトのものと同様に動作すると想定している。

SVGURIReference インターフェイス上の href メンバーの場合、 ‘href’ 属性が存在せず、 非推奨の ‘xlink:href’ 属性が 存在する場合はその属性が設定され、 その他すべての場合は ‘href’ 属性が 設定される。

4.6.8. インターフェイス SVGAnimatedRect

SVGAnimatedRect オブジェクトは、 x、y、width および height によって指定される 矩形値を取るアニメーション可能な属性を 反映するために使用される。

この仕様で SVGAnimatedRect として反映される唯一の属性は、 ‘viewBox’ である。

[Exposed=Window]
interface SVGAnimatedRect {
  [SameObject] readonly attribute SVGRect baseVal;
  [SameObject] readonly attribute SVGRect animVal;
};

baseVal および animVal IDL 属性は、反映された属性の現在の非アニメーション矩形値を表す。 baseVal または animVal を取得すると、 SVGRect オブジェクトが 返される。

baseVal または animVal の SVGRect オブジェクトが作成されたとき、および その後、反映されたコンテンツ属性が 追加、削除、または変更されるたびに、次の手順を実行する。

1. value を反映された属性の値 （存在しないか無効な場合は属性の初期値を使用する）とする。
2. x、y、width および height を、 value のそれぞれ対応する成分とする。
3. SVGRect オブジェクトの x 座標、 y 座標、 width および height を、 それぞれ x、y、width および height に 設定する。

baseVal または animVal の SVGRect オブジェクトの x 座標、 y 座標、 width または height プロパティが変更されるたびに、 コンテンツ属性の値を SVGRect に反映する前のアルゴリズムの一部として 変更される場合を除き、反映された コンテンツ属性を再シリアライズしなければならない。

4.6.9. インターフェイス SVGAnimatedNumberList

SVGAnimatedNumberList オブジェクトは、 <number> 値のリストを取る アニメーション可能な属性を反映するために使用される。

[Exposed=Window]
interface SVGAnimatedNumberList {
  [SameObject] readonly attribute SVGNumberList baseVal;
  [SameObject] readonly attribute SVGNumberList animVal;
};

baseVal および animVal IDL 属性は、 反映された属性の現在の非アニメーション値を表す。 baseVal または animVal を取得すると、 反映された属性の基底値を反映する SVGNumberList オブジェクトが返される。

4.6.10. インターフェイス SVGAnimatedLengthList

SVGAnimatedLengthList オブジェクトは、 <length>、<percentage> または <number> 値のリストを取る アニメーション可能な属性を反映するために使用される。

[Exposed=Window]
interface SVGAnimatedLengthList {
  [SameObject] readonly attribute SVGLengthList baseVal;
  [SameObject] readonly attribute SVGLengthList animVal;
};

baseVal または animVal IDL 属性は、 反映された属性の現在の非アニメーション値を表す。 baseVal または animVal を取得すると、 反映された属性の基底値を反映する SVGLengthList オブジェクトが返される。

4.7. その他の DOM インターフェイス

4.7.1. インターフェイス SVGUnitTypes

SVGUnitTypes インターフェイスは、 ‘gradientUnits’、 ‘patternContentUnits’ および その他の類似する属性を反映するために使用される、一般的に 使用される定数の集合を定義する。

[Exposed=Window]
interface SVGUnitTypes {
  // 単位型
  const unsigned short SVG_UNIT_TYPE_UNKNOWN = 0;
  const unsigned short SVG_UNIT_TYPE_USERSPACEONUSE = 1;
  const unsigned short SVG_UNIT_TYPE_OBJECTBOUNDINGBOX = 2;
};

SVGUnitTypes 上で定義される単位型定数は、次の意味を持つ。

4.7.2. ミックスイン SVGTests

SVGTests インターフェイスは、 条件付き処理属性を反映するために使用され、 これらの属性をサポートする要素の他の インターフェイスにミックスインされる。

interface mixin SVGTests {
  [SameObject] readonly attribute SVGStringList requiredExtensions;
  [SameObject] readonly attribute SVGStringList systemLanguage;
};

requiredExtensions IDL 属性は、 ‘requiredExtensions’ コンテンツ 属性を反映する。

systemLanguage IDL 属性は、 ‘systemLanguage’ コンテンツ属性を 反映する。

4.7.3. ミックスイン SVGFitToViewBox

SVGFitToViewBox インターフェイスは、 ‘viewBox’ および ‘preserveAspectRatio’ 属性を 反映するために使用され、 これら 2 つの属性をサポートする要素の他のインターフェイスに ミックスインされる。

interface mixin SVGFitToViewBox {
  [SameObject] readonly attribute SVGAnimatedRect viewBox;
  [SameObject] readonly attribute SVGAnimatedPreserveAspectRatio preserveAspectRatio;
};

viewBox IDL 属性は、 ‘viewBox’ コンテンツ属性を 反映する。

preserveAspectRatio IDL 属性は、 ‘preserveAspectRatio’ コンテンツ 属性を反映する。

4.7.4. ミックスイン SVGURIReference

SVGURIReference インターフェイスは、 ‘href’ 属性および非推奨の ‘xlink:href’ 属性を反映するために使用される。

interface mixin SVGURIReference {
  [SameObject] readonly attribute SVGAnimatedString href;
};

href IDL 属性は、 ‘href’ 属性の値、およびそれをサポートするよう定義されている要素では、 非推奨の ‘xlink:href’ 属性を表す。 href を取得すると、 次の条件を満たす SVGAnimatedString オブジェクトを返す。

• ‘href’ 属性を反映する。
• 要素が非推奨の ‘xlink:href’ 属性をサポートするよう定義されている場合、その非推奨属性も追加で反映する。

SVGAnimatedString インターフェイスは、その baseVal および animVal メンバーを通じて、 ‘href’ が存在せず、 非推奨の ‘xlink:href’ 属性が存在する場合はその属性を反映し、 その他すべての場合は ‘href’ 属性を反映するよう 定義されている。アニメーション要素は、 attributeName='xlink:href' を ‘href’ 属性を対象とする別名として扱う。