14 January 2003, 翻訳更新: 2010/04/29

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


目次


4.1 基本データ型

SVG のプロパティと属性に共通なデータ型は以下に挙げられるものに分類される:

The common data types for SVG's properties and attributes fall into the following categories:

4.2 色キーワード

次に挙げるのは <color> 型で使用できる色キーワードの一覧である。

The following is the list of recognized color keywords that can be used as a keyword value for data type <color>:

aliceblue color-patch aliceblue rgb(240, 248, 255)
antiquewhite color-patch antiquewhite rgb(250, 235, 215)
aqua color-patch aqua rgb( 0, 255, 255)
aquamarine color-patch aquamarine rgb(127, 255, 212)
azure color-patch azure rgb(240, 255, 255)
beige color-patch beige rgb(245, 245, 220)
bisque color-patch bisque rgb(255, 228, 196)
black color-patch black rgb( 0, 0, 0)
blanchedalmond color-patch blanchedalmond rgb(255, 235, 205)
blue color-patch blue rgb( 0, 0, 255)
blueviolet color-patch blueviolet rgb(138, 43, 226)
brown color-patch brown rgb(165, 42, 42)
burlywood color-patch burlywood rgb(222, 184, 135)
cadetblue color-patch cadetblue rgb( 95, 158, 160)
chartreuse color-patch chartreuse rgb(127, 255, 0)
chocolate color-patch chocolate rgb(210, 105, 30)
coral color-patch coral rgb(255, 127, 80)
cornflowerblue color-patch cornflowerblue rgb(100, 149, 237)
cornsilk color-patch cornsilk rgb(255, 248, 220)
crimson color-patch crimson rgb(220, 20, 60)
cyan color-patch cyan rgb( 0, 255, 255)
darkblue color-patch darkblue rgb( 0, 0, 139)
darkcyan color-patch darkcyan rgb( 0, 139, 139)
darkgoldenrod color-patch darkgoldenrod rgb(184, 134, 11)
darkgray color-patch darkgray rgb(169, 169, 169)
darkgreen color-patch darkgreen rgb( 0, 100, 0)
darkgrey color-patch darkgrey rgb(169, 169, 169)
darkkhaki color-patch darkkhaki rgb(189, 183, 107)
darkmagenta color-patch darkmagenta rgb(139, 0, 139)
darkolivegreen color-patch darkolivegreen rgb( 85, 107, 47)
darkorange color-patch darkorange rgb(255, 140, 0)
darkorchid color-patch darkorchid rgb(153, 50, 204)
darkred color-patch darkred rgb(139, 0, 0)
darksalmon color-patch darksalmon rgb(233, 150, 122)
darkseagreen color-patch darkseagreen rgb(143, 188, 143)
darkslateblue color-patch darkslateblue rgb( 72, 61, 139)
darkslategray color-patch darkslategray rgb( 47, 79, 79)
darkslategrey color-patch darkslategrey rgb( 47, 79, 79)
darkturquoise color-patch darkturquoise rgb( 0, 206, 209)
darkviolet color-patch darkviolet rgb(148, 0, 211)
deeppink color-patch deeppink rgb(255, 20, 147)
deepskyblue color-patch deepskyblue rgb( 0, 191, 255)
dimgray color-patch dimgray rgb(105, 105, 105)
dimgrey color-patch dimgrey rgb(105, 105, 105)
dodgerblue color-patch dodgerblue rgb( 30, 144, 255)
firebrick color-patch firebrick rgb(178, 34, 34)
floralwhite color-patch floralwhite rgb(255, 250, 240)
forestgreen color-patch forestgreen rgb( 34, 139, 34)
fuchsia color-patch fuchsia rgb(255, 0, 255)
gainsboro color-patch gainsboro rgb(220, 220, 220)
ghostwhite color-patch ghostwhite rgb(248, 248, 255)
gold color-patch gold rgb(255, 215, 0)
goldenrod color-patch goldenrod rgb(218, 165, 32)
gray color-patch gray rgb(128, 128, 128)
grey color-patch grey rgb(128, 128, 128)
green color-patch green rgb( 0, 128, 0)
greenyellow color-patch greenyellow rgb(173, 255, 47)
honeydew color-patch honeydew rgb(240, 255, 240)
hotpink color-patch hotpink rgb(255, 105, 180)
indianred color-patch indianred rgb(205, 92, 92)
indigo color-patch indigo rgb( 75, 0, 130)
ivory color-patch ivory rgb(255, 255, 240)
khaki color-patch khaki rgb(240, 230, 140)
lavender color-patch lavender rgb(230, 230, 250)
lavenderblush color-patch lavenderblush rgb(255, 240, 245)
lawngreen color-patch lawngreen rgb(124, 252, 0)
lemonchiffon color-patch lemonchiffon rgb(255, 250, 205)
lightblue color-patch lightblue rgb(173, 216, 230)
lightcoral color-patch lightcoral rgb(240, 128, 128)
lightcyan color-patch lightcyan rgb(224, 255, 255)
lightgoldenrodyellow color-patch lightgoldenrodyellow rgb(250, 250, 210)
lightgray color-patch lightgray rgb(211, 211, 211)
lightgreen color-patch lightgreen rgb(144, 238, 144)
lightgrey color-patch lightgrey rgb(211, 211, 211)
    
lightpink color-patch lightpink rgb(255, 182, 193)
lightsalmon color-patch lightsalmon rgb(255, 160, 122)
lightseagreen color-patch lightseagreen rgb( 32, 178, 170)
lightskyblue color-patch lightskyblue rgb(135, 206, 250)
lightslategray color-patch lightslategray rgb(119, 136, 153)
lightslategrey color-patch lightslategrey rgb(119, 136, 153)
lightsteelblue color-patch lightsteelblue rgb(176, 196, 222)
lightyellow color-patch lightyellow rgb(255, 255, 224)
lime color-patch lime rgb( 0, 255, 0)
limegreen color-patch limegreen rgb( 50, 205, 50)
linen color-patch linen rgb(250, 240, 230)
magenta color-patch magenta rgb(255, 0, 255)
maroon color-patch maroon rgb(128, 0, 0)
mediumaquamarine color-patch mediumaquamarine rgb(102, 205, 170)
mediumblue color-patch mediumblue rgb( 0, 0, 205)
mediumorchid color-patch mediumorchid rgb(186, 85, 211)
mediumpurple color-patch mediumpurple rgb(147, 112, 219)
mediumseagreen color-patch mediumseagreen rgb( 60, 179, 113)
mediumslateblue color-patch mediumslateblue rgb(123, 104, 238)
mediumspringgreen color-patch mediumspringgreen rgb( 0, 250, 154)
mediumturquoise color-patch mediumturquoise rgb( 72, 209, 204)
mediumvioletred color-patch mediumvioletred rgb(199, 21, 133)
midnightblue color-patch midnightblue rgb( 25, 25, 112)
mintcream color-patch mintcream rgb(245, 255, 250)
mistyrose color-patch mistyrose rgb(255, 228, 225)
moccasin color-patch moccasin rgb(255, 228, 181)
navajowhite color-patch navajowhite rgb(255, 222, 173)
navy color-patch navy rgb( 0, 0, 128)
oldlace color-patch oldlace rgb(253, 245, 230)
olive color-patch olive rgb(128, 128, 0)
olivedrab color-patch olivedrab rgb(107, 142, 35)
orange color-patch orange rgb(255, 165, 0)
orangered color-patch orangered rgb(255, 69, 0)
orchid color-patch orchid rgb(218, 112, 214)
palegoldenrod color-patch palegoldenrod rgb(238, 232, 170)
palegreen color-patch palegreen rgb(152, 251, 152)
paleturquoise color-patch paleturquoise rgb(175, 238, 238)
palevioletred color-patch palevioletred rgb(219, 112, 147)
papayawhip color-patch papayawhip rgb(255, 239, 213)
peachpuff color-patch peachpuff rgb(255, 218, 185)
peru color-patch peru rgb(205, 133, 63)
pink color-patch pink rgb(255, 192, 203)
plum color-patch plum rgb(221, 160, 221)
powderblue color-patch powderblue rgb(176, 224, 230)
purple color-patch purple rgb(128, 0, 128)
red color-patch red rgb(255, 0, 0)
rosybrown color-patch rosybrown rgb(188, 143, 143)
royalblue color-patch royalblue rgb( 65, 105, 225)
saddlebrown color-patch saddlebrown rgb(139, 69, 19)
salmon color-patch salmon rgb(250, 128, 114)
sandybrown color-patch sandybrown rgb(244, 164, 96)
seagreen color-patch seagreen rgb( 46, 139, 87)
seashell color-patch seashell rgb(255, 245, 238)
sienna color-patch sienna rgb(160, 82, 45)
silver color-patch silver rgb(192, 192, 192)
skyblue color-patch skyblue rgb(135, 206, 235)
slateblue color-patch slateblue rgb(106, 90, 205)
slategray color-patch slategray rgb(112, 128, 144)
slategrey color-patch slategrey rgb(112, 128, 144)
snow color-patch snow rgb(255, 250, 250)
springgreen color-patch springgreen rgb( 0, 255, 127)
steelblue color-patch steelblue rgb( 70, 130, 180)
tan color-patch tan rgb(210, 180, 140)
teal color-patch teal rgb( 0, 128, 128)
thistle color-patch thistle rgb(216, 191, 216)
tomato color-patch tomato rgb(255, 99, 71)
turquoise color-patch turquoise rgb( 64, 224, 208)
violet color-patch violet rgb(238, 130, 238)
wheat color-patch wheat rgb(245, 222, 179)
white color-patch white rgb(255, 255, 255)
whitesmoke color-patch whitesmoke rgb(245, 245, 245)
yellow color-patch yellow rgb(255, 255, 0)
yellowgreen color-patch yellowgreen rgb(154, 205, 50)
blank entry    

4.3 基本 DOM インターフェース

次に挙げるインターフェースが以下で定義される: SVGElement, SVGAnimatedBoolean, SVGAnimatedString, SVGStringList, SVGAnimatedEnumeration, SVGAnimatedInteger, SVGNumber, SVGAnimatedNumber, SVGNumberList, SVGAnimatedNumberList, SVGLength, SVGAnimatedLength, SVGLengthList, SVGAnimatedLengthList, SVGAngle, SVGAnimatedAngle, SVGColor, SVGICCColor, SVGRect, SVGAnimatedRect, SVGUnitTypes, SVGStylable, SVGLocatable, SVGTransformable, SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGFitToViewBox, SVGZoomAndPan, SVGViewSpec, SVGURIReference, SVGCSSRule, SVGRenderingIntent


インターフェース SVGElement

SVG 言語の要素に直接的に対応するすべての SVG DOM インターフェース(例えば SVGPathElement'path' に直接対応している)は基底クラス SVGElement から派生する。


IDL 定義
interface SVGElement : Element { 
           attribute DOMString id;
                       // raises DOMException on setting
           attribute DOMString xmlbase;
                       // raises DOMException on setting
  readonly attribute SVGSVGElement ownerSVGElement;
  readonly attribute SVGElement viewportElement;
};

属性
DOMString id
与えられた要素の id 属性に対応する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMString xmlbase
与えられた要素の xml:base 属性に対応する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly SVGSVGElement ownerSVGElement
最も近い祖先の 'svg' 要素。与えられた要素が 最も外側の svg 要素 の場合は null 。
readonly SVGElement viewportElement
現在のビューポートを確立した要素。通常は最も近い祖先の 'svg' 要素。与えられた要素が 最も外側の svg 要素 の場合は null 。

インターフェース SVGAnimatedBoolean

型 boolean のアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedBoolean { 
           attribute boolean baseVal;
                       // raises DOMException on setting
  readonly attribute boolean animVal;
};

属性
boolean baseVal
アニメーションが適用される前の与えられた属性の基底値( base value )。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly boolean animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGAnimatedString

型 DOMString のアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedString { 
           attribute DOMString baseVal;
                       // raises DOMException on setting
  readonly attribute DOMString animVal;
};

属性
DOMString baseVal
アニメーションが適用される前の与えられた属性の基底値。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly DOMString animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGStringList

このインターフェースは DOMString オブジェクトのリストを定義する。

SVGStringList は他の SVGxxxList インターフェースと同じ属性とメソッドを持つ。種々の SVGxxxList インターフェースの実装においては、単一の基底クラスの利用が考えられる。


IDL 定義
interface SVGStringList { 
  readonly attribute unsigned long numberOfItems;
  void   clear (  )
                  raises( DOMException );
  DOMString initialize ( in DOMString newItem )
                  raises( DOMException, SVGException );
  DOMString getItem ( in unsigned long index )
                  raises( DOMException );
  DOMString insertItemBefore ( in DOMString newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  DOMString replaceItem ( in DOMString newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  DOMString removeItem ( in unsigned long index )
                  raises( DOMException );
  DOMString appendItem ( in DOMString newItem )
                  raises( DOMException, SVGException );
};

属性
readonly unsigned long numberOfItems
リスト内の項目数。
メソッド
clear
リスト内に存在する全ての項目を取り除いて空にする。
パラメタ無し
戻り値無し
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
initialize
リスト内に存在する全ての項目を取り除いて空にした後、パラメタで指定された一個の項目を持つよう初期化する。
パラメタ
in DOMString newItem リストの唯一の項目となるもの。
戻り値
DOMString リストに挿入される項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
getItem
リスト内の指定された項目を返す。
パラメタ
in unsigned long index リストから返される項目を指定する添字。最初の項目が添字0。
戻り値
DOMString 指定された項目。
例外
DOMException
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
insertItemBefore
リスト内の指定された位置に項目を挿入する。最初の項目が添字0。 エラータ :次は削除) newItem がすでに何らかのリスト内に存在していた場合は、このリストに挿入される前にそのリストから取り除かれる。
パラメタ
in DOMString newItem リストに挿入される項目。
in unsigned long index この添字の項目の前に新しい項目が挿入される。最初の項目が添字0。
添字が0ならば新しい項目はリストの先頭に挿入される。添字が numberOfItems 以上ならば新しい項目はリストの末尾に挿入される。
戻り値
DOMString 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
replaceItem
リスト内に存在する項目を新しい項目に置き換える。 エラータ :次は削除) newItem がすでに何らかのリスト内に存在していた場合は、このリストに挿入される前にそのリストから取り除かれる。
パラメタ
in DOMString newItem リストに挿入される項目。
in unsigned long index 置き換える項目の添字。最初の項目が添字0。
戻り値
DOMString 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
removeItem
リストから項目を取り除く。
パラメタ
in unsigned long index 取り除かれる項目の添字。最初の項目が添字0。
戻り値
DOMString 取り除かれた項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
appendItem
リストの末尾に新しい項目を追加する。 エラータ :次は削除) newItem がすでに何らかのリスト内に存在していた場合は、このリストに挿入される前にそのリストから取り除かれる。
パラメタ
in DOMString newItem リストに挿入する項目。最初の項目が添字0。
戻り値
DOMString 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。

インターフェース SVGAnimatedEnumeration

特定の列挙定数のみを値にとるアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedEnumeration { 
           attribute unsigned short baseVal;
                       // raises DOMException on setting
  readonly attribute unsigned short animVal;
};

属性
unsigned short baseVal
アニメーションが適用される前の与えられた属性の基底値。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly unsigned short animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGAnimatedInteger

基本型 'integer' を値にとるアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedInteger { 
           attribute long baseVal;
                       // raises DOMException on setting
  readonly attribute long animVal;
};

属性
long baseVal
アニメーションが適用される前の与えられた属性の基底値。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly long animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGNumber

基本型 'number' の属性に対し利用される。


IDL 定義
interface SVGNumber { 
           attribute float value;
                       // raises DOMException on setting
};

属性
float value
与えられた属性の値。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。

インターフェース SVGAnimatedNumber

基本型 'number' を値にとるアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedNumber { 
           attribute float baseVal;
                       // raises DOMException on setting
  readonly attribute float animVal;
};

属性
float baseVal
アニメーションが適用される前の与えられた属性の基底値。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly float animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGNumberList

このインターフェースは SVGNumber オブジェクトのリストを定義する。

SVGNumberList は他の SVGxxxList インターフェースと同じ属性とメソッドを持つ。種々の SVGxxxList インターフェースの実装においては、単一の基底クラスの利用が考えられる。


IDL 定義
interface SVGNumberList { 
  readonly attribute unsigned long numberOfItems;
  void   clear (  )
                  raises( DOMException );
  SVGNumber initialize ( in SVGNumber newItem )
                  raises( DOMException, SVGException );
  SVGNumber getItem ( in unsigned long index )
                  raises( DOMException );
  SVGNumber insertItemBefore ( in SVGNumber newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGNumber replaceItem ( in SVGNumber newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGNumber removeItem ( in unsigned long index )
                  raises( DOMException );
  SVGNumber appendItem ( in SVGNumber newItem )
                  raises( DOMException, SVGException );
};

属性
readonly unsigned long numberOfItems
リスト内の項目数。
メソッド
clear
リスト内に存在する全ての項目を取り除いて空にする。
パラメタ無し
戻り値無し
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
initialize
リスト内に存在する全ての項目を取り除いて空にした後、パラメタで指定された一個の項目を持つよう初期化する。 エラータ :次を追加) 挿入される項目が既にリスト内に存在する場合、いったんリストから取り除かれた後に挿入される。このとき、挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGNumber newItem リストの唯一の項目となるもの。
戻り値
SVGNumber リストに挿入される項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
getItem
リスト内の指定された項目を返す。 エラータ :次を追加) 返される項目は複製ではなく、項目それ自身になる。項目に加えられる変更は即座にリストに反映する。
パラメタ
in unsigned long index リストから返される項目を指定する添字。最初の項目が添字0。
戻り値
SVGNumber 指定された項目。
例外
DOMException
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
insertItemBefore
リスト内の指定された位置に項目を挿入する。最初の項目が添字0。 newItem がすでに何らかのリスト内に存在していた場合は、このリストに挿入される前にそのリストから取り除かれる。 エラータ :次を追加) 挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGNumber newItem リストに挿入される項目。
in unsigned long index この添字の項目の前に新しい項目が挿入される。最初の項目が添字0。
添字が0ならば新しい項目はリストの先頭に挿入される。添字が numberOfItems 以上ならば新しい項目はリストの末尾に挿入される。
戻り値
SVGNumber 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
replaceItem
リスト内に存在する項目を新しい項目に置き換える。 newItem がすでに何らかのリスト内に存在していた場合は、このリストに挿入される前にそのリストから取り除かれる。 エラータ :次を追加) 挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGNumber newItem リストに挿入される項目。
in unsigned long index 置き換える項目の添字。最初の項目が添字0。
戻り値
SVGNumber 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
removeItem
リストから項目を取り除く。
パラメタ
in unsigned long index 取り除かれる項目の添字。最初の項目が添字0。
戻り値
SVGNumber 取り除かれた項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
appendItem
newItem がすでに何らかのリスト内に存在していた場合は、このリストに追加される前にそのリストから取り除かれる。 エラータ :次を追加) 挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGNumber newItem リストに挿入する項目。最初の項目が添字0。
戻り値
SVGNumber 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。

インターフェース SVGAnimatedNumberList

数値のリストを値にとるアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedNumberList { 
  readonly attribute SVGNumberList baseVal;
  readonly attribute SVGNumberList animVal;
};

属性
readonly SVGNumberList baseVal
アニメーションが適用される前の与えられた属性の基底値。
readonly SVGNumberList animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値をとり、オブジェクト自身とその内容は読み出し専用となる。アニメーションされていない場合 'baseVal' と同じ値をとる。

インターフェース SVGLength

SVGLength インターフェースは基本型 <length> に対応する。


IDL 定義
interface SVGLength { 
  // Length Unit Types
  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;
                       // raises DOMException on setting
           attribute float          valueInSpecifiedUnits;
                       // raises DOMException on setting
           attribute DOMString      valueAsString;
                       // raises DOMException on setting
  void newValueSpecifiedUnits ( in unsigned short unitType, in float valueInSpecifiedUnits );
                  raises( DOMException );
  void convertToSpecifiedUnits ( in unsigned short unitType );
                  raises( DOMException );
};

定義グループ Length Unit Types
定義されている定数
SVG_LENGTHTYPE_UNKNOWN タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。
SVG_LENGTHTYPE_NUMBER 単位タイプが与えられていないことを表し(即ち単位無しの値が指定されている)、値が利用単位によるものであることを意味する
SVG_LENGTHTYPE_PERCENTAGE パーセントによる値が指定されている。
SVG_LENGTHTYPE_EMS 値が CSS2 の単位 "em" で指定されている。
SVG_LENGTHTYPE_EXS 値が CSS2 の単位 "ex" で指定されている。
SVG_LENGTHTYPE_PX 値が CSS2 の単位 "px" で指定されている。
SVG_LENGTHTYPE_CM 値が CSS2 の単位 "cm" で指定されている。
SVG_LENGTHTYPE_MM 値が CSS2 の単位 "mm" で指定されている。
SVG_LENGTHTYPE_IN 値が CSS2 の単位 "in" で指定されている。
SVG_LENGTHTYPE_PT 値が CSS2 の単位 "pt" で指定されている。
SVG_LENGTHTYPE_PC 値が CSS2 の単位 "pc" で指定されている。
属性
readonly unsigned short unitType
上の Length Unit Types で定義された定数のいずれか。
float value
利用単位による浮動小数点値。この属性を設定することは、その反映として valueInSpecifiedUnits と valueAsString が自動的に更新されることを意味する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
float valueInSpecifiedUnits
unitType で表される単位による浮動小数点値。この属性を設定することは、その反映として value と valueAsString が自動的に更新されることを意味する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMString valueAsString
エラータ :次を修正) unitType で表される単位による文字列値。文字列による長さ値。 この属性を設定することは、その反映として value, valueInSpecifiedUnits, unitType が自動的に更新されることを意味する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMException あてがわれた文字列が有効な <length> に構文解析できない場合にレイズされる。
メソッド
newValueSpecifiedUnits
値を unitType に結び付けられるように再設定する。その結果オブジェクトの全ての属性値も置換される。
パラメタ
in unsigned short unitType 値の単位を指示する(例えば SVG_LENGTHTYPE_MM )。
in float valueInSpecifiedUnits 新しく設定する値。
戻り値無し
例外無し
例外
DOMException
DOMException NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMException
NOT_SUPPORTED_ERR: unitType が SVG_LENGTHTYPE_UNKNOWN か、無効な単位型定数(このインターフェースで定義されていない SVG_LENGTHTYPE_* 定数)の場合にレイズされる。 エラータ
convertToSpecifiedUnits
根底にある値は同じままに保ちつつ、単位識別子を与えられた unitType に再設定する。オブジェクトの属性 unitType, valueAsSpecified, valueAsString はこのメソッドにより変更され得る。例えば、元の値が "0.5cm" であったとしてミリメートルに変換するようにこのメソッドを呼び出したとすると、 unitType は SVG_LENGTHTYPE_MM に, valueAsSpecified 数値 5 に, valueAsString は "5mm" に変更される。
パラメタ
in unsigned short unitType 設定する unitType (例えば SVG_LENGTHTYPE_MM )。
戻り値無し
例外無し
例外
DOMException
DOMException NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMException
NOT_SUPPORTED_ERR: unitType が SVG_LENGTHTYPE_UNKNOWN か、無効な単位型定数(このインターフェースで定義されていない SVG_LENGTHTYPE_* 定数)の場合にレイズされる。 エラータ

インターフェース SVGAnimatedLength

基本型 'length' を値にとるアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedLength { 
  readonly attribute SVGLength baseVal;
  readonly attribute SVGLength animVal;
};

属性
readonly SVGLength baseVal
アニメーションが適用される前の与えられた属性の基底値。
readonly SVGLength animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値をとり、オブジェクト自身とその内容は読み出し専用となる。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGLengthList

このインターフェースは SVGLength オブジェクトのリストを定義する。

SVGLengthList は他の SVGxxxList インターフェースと同じ属性とメソッドを持つ。種々の SVGxxxList インターフェースの実装においては、単一の基底クラスの利用が考えられる。


IDL 定義
interface SVGLengthList { 
  readonly attribute unsigned long numberOfItems;
  void   clear (  )
                  raises( DOMException );
  SVGLength initialize ( in SVGLength newItem )
                  raises( DOMException, SVGException );
  SVGLength getItem ( in unsigned long index )
                  raises( DOMException );
  SVGLength insertItemBefore ( in SVGLength newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGLength replaceItem ( in SVGLength newItem, in unsigned long index )
                  raises( DOMException, SVGException );
  SVGLength removeItem ( in unsigned long index )
                  raises( DOMException );
  SVGLength appendItem ( in SVGLength newItem )
                  raises( DOMException, SVGException );
};

属性
readonly unsigned long numberOfItems
リスト内の項目数。
メソッド
clear
リスト内に存在する全ての項目を取り除いて空にする。
パラメタ無し
戻り値無し
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
initialize
リスト内に存在する全ての項目を取り除いて空にした後、パラメタで指定された一個の項目を持つよう初期化する。 エラータ :次を追加) 挿入される項目が既にリスト内に存在する場合、いったんリストから取り除かれた後に挿入される。このとき、挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGLength newItem リストの唯一の項目となるもの。
戻り値
SVGLength リストに挿入される項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
getItem
リスト内の指定された項目を返す。 エラータ :次を追加) 返される項目は複製ではなく、項目それ自身になる。項目に加えられる変更は即座にリストに反映する。
パラメタ
in unsigned long index リストから返される項目を指定する添字。最初の項目が添字0。
戻り値
SVGLength 指定された項目。
例外
DOMException
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
insertItemBefore
リスト内の指定された位置に項目を挿入する。最初の項目が添字0。 newItem がすでに何らかのリスト内に存在していた場合は、このリストに挿入される前にそのリストから取り除かれる。 エラータ :次を追加) 挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGLength newItem リストに挿入される項目。
in unsigned long index この添字の項目の前に新しい項目が挿入される。最初の項目が添字0。
添字が0ならば新しい項目はリストの先頭に挿入される。添字が numberOfItems 以上ならば新しい項目はリストの末尾に挿入される。
戻り値
SVGLength 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
replaceItem
リスト内に存在する項目を新しい項目に置き換える。 newItem がすでに何らかのリスト内に存在していた場合は、このリストに追加される前にそのリストから取り除かれる。 エラータ :次を追加) 挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGLength newItem リストに挿入される項目。
in unsigned long index 置き換える項目の添字。最初の項目が添字0。
戻り値
SVGLength 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
removeItem
リストから項目を取り除く。
パラメタ
in unsigned long index 取り除かれる項目の添字。最初の項目が添字0。
戻り値
SVGLength 取り除かれた項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
appendItem
newItem がすでに何らかのリスト内に存在していた場合は、このリストに追加される前にそのリストから取り除かれる。 エラータ :次を追加) 挿入される項目は項目それ自身であり、複製はされない。
パラメタ
in SVGLength newItem リストに挿入する項目。最初の項目が添字0。
戻り値
SVGLength 挿入された項目。
例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
SVGException
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。

インターフェース SVGAnimatedLengthList

型 SVGLengthList のアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedLengthList { 
  readonly attribute SVGLengthList baseVal;
  readonly attribute SVGLengthList animVal;
};

属性
readonly SVGLengthList baseVal
アニメーションが適用される前の与えられた属性の基底値。
readonly SVGLengthList animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値をとり、オブジェクト自身とその内容は読み出し専用となる。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGAngle

SVGAngle インターフェースは基本データ型 <angle> に対応する。


IDL 定義
interface SVGAngle { 
  // Angle Unit Types
  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;
                       // raises DOMException on setting
           attribute float          valueInSpecifiedUnits;
                       // raises DOMException on setting
           attribute DOMString      valueAsString;
                       // raises DOMException on setting
  void newValueSpecifiedUnits ( in unsigned short unitType, in float valueInSpecifiedUnits );
                  raises( DOMException );
  void convertToSpecifiedUnits ( in unsigned short unitType );
                  raises( DOMException );
};

定義グループ Angle Unit Types
定義されている定数
SVG_ANGLETYPE_UNKNOWN タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。
SVG_ANGLETYPE_UNSPECIFIED 単位タイプが与えられていないことを表す(即ち単位無しの値が指定されている)。角度においては、単位無しの値は単位として度が指定されたものと見なされる。
SVG_ANGLETYPE_DEG 値の単位が明示的に度に設定されている。
SVG_ANGLETYPE_RAD 値が単位ラジアンで指定されている。
SVG_ANGLETYPE_GRAD 値が単位グラードで指定されている。
属性
readonly unsigned short unitType
上の Angle Unit Types で定義された定数のいずれか。
float value
度による浮動小数点値の角度。この属性を設定することは、その反映として valueInSpecifiedUnits と valueAsString が自動的に更新されることを意味する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
float valueInSpecifiedUnits
unitType で指示される単位による浮動小数点値の角度。この属性を設定することは、その反映として value と valueAsString が自動的に更新されることを意味する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMString valueAsString
エラータ :次を修正) unitType で指示される単位による文字列で表される角度。文字列による角度値。 この属性を設定することは、その反映として value, valueInSpecifiedUnits, unitType が自動的に更新されることを意味する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMException あてがわれた文字列が有効な <angle> に構文解析できない場合にレイズされる。
メソッド
newValueSpecifiedUnits
値を unitType に結び付けられるように再設定する。その結果オブジェクトの全ての属性値も置換される。
パラメタ
in unsigned short unitType 角度値の unitType (例えば SVG_ANGLETYPE_DEG )。
in float valueInSpecifiedUnits 角度値。
戻り値無し
例外無し
例外
DOMException
DOMException NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMException
NOT_SUPPORTED_ERR: unitType が SVG_ANGLETYPE_UNKNOWN か、無効な単位型定数(このインターフェースで定義されていない SVG_ANGLETYPE_* 定数)の場合にレイズされる。 エラータ
convertToSpecifiedUnits
根底にある値は同じままに保ちつつ、単位識別子を与えられた unitType に再設定する。オブジェクトの属性 unitType, valueAsSpecified, valueAsString はこのメソッドにより変更され得る。
パラメタ
in unsigned short unitType unitType に設定するタイプ(例えば SVG_ANGLETYPE_DEG )。
戻り値無し
例外無し
例外
DOMException
DOMException NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMException
NOT_SUPPORTED_ERR: unitType が SVG_ANGLETYPE_UNKNOWN か、無効な単位型定数(このインターフェースで定義されていない SVG_ANGLETYPE_* 定数)の場合にレイズされる。 エラータ

インターフェース SVGAnimatedAngle

基本型 'angle' を値にとるアニメーション可能な全てのプロパティと属性に対応する。


IDL 定義
interface SVGAnimatedAngle { 
  readonly attribute SVGAngle baseVal;
  readonly attribute SVGAngle animVal;
};

属性
readonly SVGAngle baseVal
アニメーションが適用される前の与えられた属性の基底値。
readonly SVGAngle animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値をとり、オブジェクト自身とその内容は読み出し専用となる。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGColor

SVGColor インターフェースは 'stop-color', 'flood-color', 'lighting-color' プロパティにおける色値定義に対応し、 SVGPaint の基底クラスである。 これは、 ICC ベースの色指定を組み込んだ SVG の拡張された色の概念を組み込むものである。

SVGColor インターフェースは基本データ型 <color> に対応するものではない。基本データ型 <color> に適用可能な DOM インターフェースは [DOM2-CSS] で定義されている。特に、 [DOM2-CSS-RGBCOLOR] を参照のこと。


IDL 定義
interface SVGColor : css::CSSValue { 
  // Color Types
  const unsigned short SVG_COLORTYPE_UNKNOWN           = 0;
  const unsigned short SVG_COLORTYPE_RGBCOLOR          = 1;
  const unsigned short SVG_COLORTYPE_RGBCOLOR_ICCCOLOR = 2;
  const unsigned short SVG_COLORTYPE_CURRENTCOLOR      = 3;
  readonly attribute unsigned short colorType;
  readonly attribute css::RGBColor  rgbColor;
  readonly attribute SVGICCColor    iccColor;
  void        setRGBColor ( in DOMString rgbColor )
                  raises( SVGException );
  void        setRGBColorICCColor ( in DOMString rgbColor, in DOMString iccColor )
                  raises( SVGException );
  void        setColor ( in unsigned short colorType, in DOMString rgbColor, in DOMString iccColor )
                  raises( SVGException );
};

定義グループ Color Types
定義されている定数
SVG_COLORTYPE_UNKNOWN タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。
SVG_COLORTYPE_RGBCOLOR sRGB 色が指定されているが代替 ICC 色は指定されていない。
SVG_COLORTYPE_RGBCOLOR_ICCCOLOR sRGB 色が代替 ICC 色とともに指定されている。
SVG_COLORTYPE_CURRENTCOLOR キーワード 'currentColor' が指定されている状態に対応する。
属性
readonly unsigned short colorType
上の Color Types で定義された定数のいずれか。
readonly css::RGBColor rgbColor
sRGB 色空間で指定される色。
readonly SVGICCColor iccColor
代替 ICC 色指定。
メソッド
setRGBColor
色値を代替 ICC 色指定を与えずに指定された sRGB 色に変更する。
パラメタ
in DOMString rgbColor 新しい色値。
戻り値無し
例外
SVGException
SVG_INVALID_VALUE_ERR :パラメタのいずれかが無効な値のときにレイズされる。
setRGBColorICCColor
色値を代替 ICC 色指定とともに指定された sRGB 色に変更する。
パラメタ
in DOMString rgbColor 新しい色値。
in DOMString iccColor 代替 ICC 色の指定。
戻り値無し
例外
SVGException
SVG_INVALID_VALUE_ERR :パラメタのいずれかが無効な値のときにレイズされる。
setColor
colorType をパラメタで指定されたタイプに設定する。 colorType が RGBColor を要求する場合、 rgbColor は有効な RGBColor オブジェクトでなければならず、そうでない場合の rgbColor は null でなければならない。 colorType が SVGICCColor を要求する場合、 rgbColor は有効な SVGICCColor オブジェクトでなければならず、そうでない場合の rgbColor は null でなければならない。
パラメタ
in unsigned short colorType 上の Color Types で定義された定数のいずれか。
in DOMString rgbColor sRGB 色指定か、あるいは null 。
in DOMString iccColor ICC 色指定か、あるいは null 。
戻り値無し
例外
SVGException
SVG_INVALID_VALUE_ERR :パラメタのいずれかが無効な値のときにレイズされる。

インターフェース SVGICCColor

SVGICCColor インターフェースは ICC ベースの色指定を表現する。


IDL 定義
interface SVGICCColor { 
           attribute DOMString      colorProfile;
                       // raises DOMException on setting
  readonly attribute SVGNumberList colors;
};

属性
DOMString colorProfile

ICC 色指定における最初のパラメタである、カラープロファイル名。

設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
readonly SVGNumberList colors

この ICC 色を定義する色値のリスト。各色値は任意の浮動小数点数。


インターフェース SVGRect

矩形はXの最小値とYの最小値を指定する座標 (x,y) 、および通常は負にならないよう制約される width と height から定義される。


IDL 定義
interface SVGRect { 
           attribute float x;
                       // raises DOMException on setting
           attribute float y;
                       // raises DOMException on setting
           attribute float width;
                       // raises DOMException on setting
           attribute float height;
                       // raises DOMException on setting
};

属性
float x
与えられた要素の x 属性に対応する。 エラータ :次に変更) 利用単位で表される矩形のX座標。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR : 読み出し専用の属性値の変更を試みたときにレイズされる。 エラータ :次に変更) SVGRect オブジェクトが読み出し専用であった場合、もしくは対応する DOM 属性が読み出し専用であった場合にレイズされる。
float y
与えられた要素の y 属性に対応する。 エラータ :次に変更) 利用単位で表される矩形のY座標。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR : 読み出し専用の属性値の変更を試みたときにレイズされる。 エラータ :次に変更) SVGRect オブジェクトが読み出し専用であった場合、もしくは対応する DOM 属性が読み出し専用であった場合にレイズされる。
float width
与えられた要素の width 属性に対応する。 エラータ :次に変更) 利用単位で表される矩形の幅。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR : 読み出し専用の属性値の変更を試みたときにレイズされる。 エラータ :次に変更) SVGRect オブジェクトが読み出し専用であった場合、もしくは対応する DOM 属性が読み出し専用であった場合にレイズされる。
float height
与えられた要素の height 属性に対応する。 エラータ :次に変更) 利用単位で表される矩形の高さ。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR : 読み出し専用の属性値の変更を試みたときにレイズされる。 エラータ :次に変更) SVGRect オブジェクトが読み出し専用であった場合、もしくは対応する DOM 属性が読み出し専用であった場合にレイズされる。

インターフェース SVGAnimatedRect

型 SVGRect のアニメーション可能な属性に対し利用される。


IDL 定義
interface SVGAnimatedRect { 
  readonly attribute SVGRect baseVal;
  readonly attribute SVGRect animVal;
};

属性
readonly SVGRect baseVal
アニメーションが適用される前の与えられた属性の基底値。
readonly SVGRect animVal
与えられた属性またはプロパティがアニメーションされている場合、そのアニメーションされた値をとり、オブジェクト自身とその内容は読み出し専用となる。アニメーションされていない場合は 'baseVal' と同じ値をとる。

インターフェース SVGUnitTypes

SVGUnitTypes インターフェースは共通して利用される定数を定義し、次のインターフェース: SVGGradientElement, SVGPatternElement, SVGClipPathElement, SVGMaskElement, SVGFilterElement の基底インターフェースとなるものである。


IDL 定義
interface SVGUnitTypes { 
  // Unit Types
  const unsigned short SVG_UNIT_TYPE_UNKNOWN           = 0;
  const unsigned short SVG_UNIT_TYPE_USERSPACEONUSE    = 1;
  const unsigned short SVG_UNIT_TYPE_OBJECTBOUNDINGBOX = 2;
};

定義グループ Unit Types
定義されている定数
SVG_UNIT_TYPE_UNKNOWN タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。
SVG_UNIT_TYPE_USERSPACEONUSE userSpaceOnUse に対応する。
SVG_UNIT_TYPE_OBJECTBOUNDINGBOX objectBoundingBox に対応する。

インターフェース SVGStylable


IDL 定義
interface SVGStylable { 
  readonly attribute SVGAnimatedString className;
  readonly attribute css::CSSStyleDeclaration style;
  css::CSSValue getPresentationAttribute ( in DOMString name );
};

属性
readonly SVGAnimatedString className
与えられた要素の class 属性に対応する。
readonly css::CSSStyleDeclaration style
与えられた要素の style 属性に対応する。UAが CSS によるスタイル付け をサポートしない場合、この属性の値は常に null でなければならない。
メソッド
getPresentationAttribute
与えられたプレゼンテーション属性の基底(即ち静的)値を CSSValue 型のオブジェクトとして返す。返されたオブジェクトは生きた状態であり、それに対する変更は CSSValue を付けられたオブジェクトに即座に反映される。
パラメタ
in DOMString name 「プレゼンテーション属性」をその名前から取り出す。
戻り値
css::CSSValue

与えられたプレゼンテーション属性の静的/基底値を CSSValue として表したもの、または属性に値が指定されていない場合は null 。

例外無し

インターフェース SVGLocatable

SVGLocatable インターフェースは transform 属性を持つか、あるいは transform 属性は持たないがその内容が現在の利用空間における包含ボックスを持ち得るような全ての要素に対し利用できる。


IDL 定義
interface SVGLocatable { 
  readonly attribute SVGElement              nearestViewportElement;
  readonly attribute SVGElement              farthestViewportElement;
  SVGRect   getBBox (  );
  SVGMatrix getCTM (  );
  SVGMatrix getScreenCTM (  );
  SVGMatrix getTransformToElement ( in SVGElement element )
                  raises( SVGException );
};

属性
readonly SVGElement nearestViewportElement
現在のビューポートを確立した要素。通常は最も近い祖先の 'svg' 要素。与えられた要素が 最も外側の svg 要素 の場合は null 。
readonly SVGElement farthestViewportElement
最も遠い祖先の 'svg' 要素。与えられた要素が 最も外側の svg 要素 の場合は null 。
メソッド
getBBox
現在の利用空間(即ち transform 属性がもしあればその適用後)における、包含する全てのグラフィックス要素の stroke-width とフィルタ効果を除く幾何を囲む最小の包含ボックスを返す。 エラータ :次を追加) getBBox は、たとえまだ描画されていなくとも、メソッドが呼び出された時点での包含ボックスを返さなければならないことに注意。
パラメタ無し
戻り値
SVGRect 包含ボックスを定義する SVGRect オブジェクト。
例外無し
getCTM
nearestViewportElement に対する、現在の利用座標系(即ち transform 属性がもしあればその適用後)からビューポート座標系への変換行列を返す。
パラメタ無し
戻り値
SVGMatrix CTM を定義する SVGMatrix オブジェクト。
例外無し
getScreenCTM
現在の利用単位(即ち transform 属性がもしあればその適用後)から親のUAから通知された「画素」への変換行列を返す。ディスプレイ装置においては、これは理想的には物理的なスクリーンの画素を表す。物理的な画素の大きさが知られない他の装置あるいは環境においては、 CSS2 による「画素」の定義と同様なアルゴリズムを利用してもよい。 エラータ :次を追加) この要素が文書木に結びつけられていない場合 null が返されることに注意。このメソッドは正しくは getClientCTM と命名されるべきであるが、歴史的な理由によりこの名前 getScreenCTM が保持されている。
パラメタ無し
戻り値
SVGMatrix 与えられた変換行列を定義する SVGMatrix オブジェクト。
例外無し
getTransformToElement
現在の要素の利用座標系から( transform 属性がもしあればその適用後) element パラメタで与えられる要素の利用座標系への(その transform 属性がもしあればその適用後)変換行列を返す。
パラメタ
in SVGElement element 要素。
戻り値
SVGMatrix 変換を定義する SVGMatrix オブジェクト。
例外
SVGException
SVG_MATRIX_NOT_INVERTABLE :現在定義されている変換行列たちによる行列の計算が不可能なときレイズされる(例えば1つの変換が特異である - singular :逆行列を持たない - などの理由で)。

インターフェース SVGTransformable

SVGTransformable インターフェースは transform 属性を持つ全ての要素に適用されるプロパティとメソッドを含む。


IDL 定義
interface SVGTransformable : SVGLocatable { 
  readonly attribute SVGAnimatedTransformList transform;
};

属性
readonly SVGAnimatedTransformList transform
与えられた要素の transform 属性に対応する。

インターフェース SVGTests

SVGTests インターフェースは requiredFeatures, requiredExtensions, systemLanguage 属性を持つ全ての要素に適用されるインターフェースを定義する。


IDL 定義
interface SVGTests { 
  readonly attribute SVGStringList requiredFeatures;
  readonly attribute SVGStringList requiredExtensions;
  readonly attribute SVGStringList systemLanguage;
  boolean hasExtension ( in DOMString extension );
};

属性
readonly SVGStringList requiredFeatures
与えられた要素の requiredFeatures 属性に対応する。
readonly SVGStringList requiredExtensions
与えられた要素の requiredExtensions 属性に対応する。
readonly SVGStringList systemLanguage
与えられた要素の systemLanguage 属性に対応する。
メソッド
hasExtension
URI で指定される拡張をUAがサポートする場合 true を返す。
パラメタ
in DOMString extension URI で表記される拡張の名前。
戻り値
boolean 与えられた拡張がサポートされるかどうかによって true か false を返す。
例外無し

インターフェース SVGLangSpace

SVGLangSpace インターフェースは xml:langxml:space 属性を持つ全ての要素に適用されるインターフェースを定義する。


IDL 定義
interface SVGLangSpace { 
           attribute DOMString xmllang;
                       // raises DOMException on setting
           attribute DOMString xmlspace;
                       // raises DOMException on setting
};

属性
DOMString xmllang
与えられた要素の xml:lang 属性に対応する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
DOMString xmlspace
与えられた要素の xml:space 属性に対応する。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。

インターフェース SVGExternalResourcesRequired

SVGExternalResourcesRequired インターフェースは要素またはその子孫が外部リソースを参照できるような全ての要素に適用されるインターフェースを定義する。


IDL 定義
interface SVGExternalResourcesRequired { 
  readonly attribute SVGAnimatedBoolean externalResourcesRequired;
};

属性
readonly SVGAnimatedBoolean externalResourcesRequired
与えられた要素の externalResourcesRequired 属性に対応する。 SVG DOM では externalResourcesRequired 属性を型 SVGAnimatedBoolean として定義している一方、 SVG 言語の定義では externalResourcesRequired はアニメーションされない/できないことになっているに注意。したがって、 animVal は常に baseVal と同じ値である。

インターフェース SVGFitToViewBox

SVGFitToViewBox インターフェースは XML 属性 viewBoxpreserveAspectRatio を持つ要素に適用される DOM 属性を定義する。


IDL 定義
interface SVGFitToViewBox { 
  readonly attribute SVGAnimatedRect                viewBox;
  readonly attribute SVGAnimatedPreserveAspectRatio preserveAspectRatio;
};

属性
readonly SVGAnimatedRect viewBox
与えられた要素の viewBox 属性に対応する。
readonly SVGAnimatedPreserveAspectRatio preserveAspectRatio
与えられた要素の preserveAspectRatio 属性に対応する。

インターフェース SVGZoomAndPan

SVGZoomAndPan インターフェースは "zoomAndPan" 属性および関連する定数を定義する。


IDL 定義
interface SVGZoomAndPan { 
  // Zoom and Pan Types
  const unsigned short SVG_ZOOMANDPAN_UNKNOWN   = 0;
  const unsigned short SVG_ZOOMANDPAN_DISABLE = 1;
  const unsigned short SVG_ZOOMANDPAN_MAGNIFY = 2;
           attribute unsigned short zoomAndPan;
                       // raises DOMException on setting
};

定義グループ Zoom and Pan Types
定義されている定数
SVG_ZOOMANDPAN_UNKNOWN タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。
SVG_ZOOMANDPAN_DISABLE disable に対応する。
SVG_ZOOMANDPAN_MAGNIFY magnify に対応する。
属性
unsigned short zoomAndPan
与えられた要素の zoomAndPan 属性に対応する。上の Zoom and Pan Types で定義された定数のいずれか。
設定時の例外
DOMException
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。

インターフェース SVGViewSpec

このインターフェースは SVG ビュー指定に対応する。


IDL 定義
interface SVGViewSpec : 
                SVGZoomAndPan,
                SVGFitToViewBox { 
  readonly attribute SVGTransformList transform;
  readonly attribute SVGElement       viewTarget;
  readonly attribute DOMString        viewBoxString;
  readonly attribute DOMString        preserveAspectRatioString;
  readonly attribute DOMString        transformString;
  readonly attribute DOMString        viewTargetString;
};

属性
readonly SVGTransformList transform
SVG ビュー指定における transform の設定に対応する。
readonly SVGElement viewTarget
SVG ビュー指定における viewTarget の設定に対応する。
readonly DOMString viewBoxString
SVG ビュー指定における viewBox の設定に対応する。
readonly DOMString preserveAspectRatioString
SVG ビュー指定における preserveAspectRatio の設定に対応する。
readonly DOMString transformString
SVG ビュー指定における transform の設定に対応する。
readonly DOMString viewTargetString
SVG ビュー指定における viewTarget の設定に対応する。

インターフェース SVGURIReference

SVGURIReference インターフェースは xlink:href などの URI 参照を定める一連の XLink 属性を持つ全ての要素に適用されるインターフェースを定義する。


IDL 定義
interface SVGURIReference { 
  readonly attribute SVGAnimatedString href;
};

属性
readonly SVGAnimatedString href
与えられた要素の xlink:href 属性に対応する。

インターフェース SVGCSSRule

SVG では ICC ベースの色指定を可能にするための SVGColorProfileRule 規則を追加して CSSRule インターフェースを SVGCSSRule インターフェースに拡張している。

この拡張は将来版の CSS と DOM の一部となることが見込まれている。


IDL 定義
interface SVGCSSRule : css::CSSRule { 
  // Additional CSS RuleType to support ICC color specifications
  const unsigned short COLOR_PROFILE_RULE = 7;
};

定義グループ ICC 色指定をサポートするための追加の CSS RuleType
定義されている定数
COLOR_PROFILE_RULE 規則が @color-profile である。

インターフェース SVGRenderingIntent

SVGRenderingIntent インターフェースは 'rendering-intent' 属性および記述に対応する可能な値の列挙を定義する。


IDL 定義
interface SVGRenderingIntent { 
  // Rendering Intent Types
  const unsigned short RENDERING_INTENT_UNKNOWN               = 0;
  const unsigned short RENDERING_INTENT_AUTO                  = 1;
  const unsigned short RENDERING_INTENT_PERCEPTUAL            = 2;
  const unsigned short RENDERING_INTENT_RELATIVE_COLORIMETRIC = 3;
  const unsigned short RENDERING_INTENT_SATURATION            = 4;
  const unsigned short RENDERING_INTENT_ABSOLUTE_COLORIMETRIC = 5;
};

定義グループ Rendering Intent Types
定義されている定数
RENDERING_INTENT_UNKNOWN タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。
RENDERING_INTENT_AUTO auto に対応する。
RENDERING_INTENT_PERCEPTUAL perceptual に対応する。
RENDERING_INTENT_RELATIVE_COLORIMETRIC relative-colorimetric に対応する。
RENDERING_INTENT_SATURATION saturation に対応する。
RENDERING_INTENT_ABSOLUTE_COLORIMETRIC absolute-colorimetric に対応する。