SVG のプロパティと属性に共通なデータ型は以下に挙げられるものに分類される:
The common data types for SVG's properties and attributes fall into the following categories:
<integer> (整数):<integer> は省略可能な正負を表す符号('+' か '-')に続く一桁以上の '0' から '9' までの数字によって指定される。符号が省略された場合は正の数とみなされる。
<integer> : An <integer> is specified as an optional sign character ('+' or '-') followed by one or more digits "0" to "9". If the sign character is not present, the number is non-negative.
特定の属性または プロパティ については前もって数値範囲が指定されていることがあるが、それ以外の場合、<integer> は(少なくとも) -2147483648 から 2147483647 までの範囲をとることができる。
Unless stated otherwise for a particular attribute or property , the range for a <integer> encompasses (at a minimum) -2147483648 to 2147483647.
SVG DOM においては <integer> は long または SVGAnimatedInteger で表現される。
Within the SVG DOM, an <integer> is represented as an long or an SVGAnimatedInteger.
<number> (実数値): 実数の記述仕様はプロパティ値として与える場合と XML 属性値として与える場合では異なる。
<number> (real number value): The specification of real number values is different for property values than for XML attribute values.
特定の属性または プロパティ のために特に指定されている場合を除き、<number> には最低限単精度の浮動小数点数( [ICC32] 参照のこと)の容量があり、(少なくとも) -3.4e+38F から +3.4e+38F までの範囲をとることができる。
Unless stated otherwise for a particular attribute or property, a <number> has the capacity for at least a single-precision floating point number (see [ICC32]) and has a range (at a minimum) of -3.4e+38F to +3.4e+38F.
座標系変換などの数値演算においては、精度を可能な限り保持して丸め誤差を低減するためにも、記憶装置も含めより高精度の浮動小数点数による演算を行うことが推奨される。
It is recommended that higher precision floating point storage and computation be performed on operations such as coordinate system transformations to provide the best possible precision and to prevent round-off errors.
特に、 適合高品質 SVG ビューア に対しては、計算の中間過程の相当部分の数値演算において、少なくとも倍精度の浮動小数点( [ICC32] 参照のこと)を使用することが要求される。
Conforming High-Quality SVG Viewers are required to use at least double-precision floating point (see [ICC32]) for intermediate calculations on certain numerical operations.
SVG DOM においては <number> は float または SVGAnimatedNumber で表現される。
Within the SVG DOM, a <number> is represented as a float or an SVGAnimatedNumber.
<length> (長さ):長さとは距離を測ったもののことである。<length> は <number> と直後に置く 単位識別子 で記述される。単位識別子は省略可能である。( <number> の記述仕様が プロパティ 値と XML 属性値では異なっていることに注意。) ( エラータ :ここでのプロパティ値は CSS2 プロパティ値。)
<length>: A length is a distance measurement. The format of a <length> is a <number> optionally followed immediately by a unit identifier. (Note that the specification of a <number> is different for property values than for XML attribute values.)
単位識別子が省略されていた場合(例: 48 )、現在の利用座標系における距離を表す。
If the <length> is expressed as a value without a unit identifier (e.g., 48), then the <length> represents a distance in the current user coordinate system.
単位識別子 が与えられていた場合(例: 12mm )の処理は 単位 の節で述べる。
If one of the unit identifiers is provided (e.g., 12mm), then the <length> is processed according to the description in Units.
長さがパーセントで指定されていた場合(例えば 10% )、実際の長さはその値を持つ属性またはプロパティに依存して定まる。通例、パーセントは (a) ビューポートに相対的な値を表すか( 単位 を見よ)、あるいは (b) オブジェクトの包含ボックスに相対的な値を表す( オブジェクトの包含ボックスに対する相対的な単位 を見よ)。
Percentage values (e.g., 10%) depend on the particular property or attribute to which the percentage value has been assigned. Two common cases are: (a) when a percentage value represents a percent of the viewport (refer to the section that discusses Units in general), and (b) when a percentage value represents a percent of the bounding box on a given object (refer to the section that describes Object bounding box units).
SVG DOM においては <length> は SVGLength または SVGAnimatedLength として表現される。
Within the SVG DOM, a <length> is represented as an SVGLength or an SVGAnimatedLength.
<coordinate> (座標成分):<coordinate> は利用座標系における、X座標の場合はX軸, Y座標の場合はY軸に沿った、原点からの(正負も含めた)距離を意味する <length> を表す。
<coordinate>: A <coordinate> represents a <length> in the user coordinate system that is the given distance from the origin of the user coordinate system along the relevant axis (the x-axis for X coordinates, the y-axis for Y coordinates).
SVG DOM においては <coordinate> は SVGLength または SVGAnimatedLength として表現される。
Within the SVG DOM, a <coordinate> is represented as an SVGLength or an SVGAnimatedLength since both values have the same syntax.
<list of xxx> ( xxx のリスト, ここで xxx は何らかの値の型を表す): リストは順序付けられた一連の値からなる。リストの記述仕様は XML 属性の値として与える場合と プロパティ 値として与える場合では異なる。
<list of xxx> (where xxx represents a value of some type): A list consists of a separated sequence of values. The specification of lists is different for property values than for XML attribute values.
リストにおける空白とは次に挙げる文字の1つ以上の連なりとして定義される:"space" (ユニコードの文字コード 32), "tab" (9), "line feed" (10), "carriage return" (13), "form-feed" (12)。
White space in lists is defined as one or more of the following consecutive characters: "space" (Unicode code 32), "tab" (9), "line feed" (10), "carriage return" (13) and "form-feed" (12).
SVG DOM においては <list of xxx> は SVGTransformList など、様々なカスタムインターフェースで定義されている。
Within the SVG DOM, a <list of xxx> is represented by various custom interfaces, such as SVGTransformList.
<list of xxx> の記述仕様を下に示す:
Here is a description of the grammar for a <list of xxx>:
ListOfXXX: XXX | XXX comma-wsp ListOfXXX comma-wsp: (wsp+ comma? wsp*) | (comma wsp*) comma: "," wsp: (#x20 | #x9 | #xD | #xA)
ここで XXX は特定の型を意味する。
where XXX represents a particular type of value.
<number-optional-number> : <list of xxx> の特殊な場合であり、1つまたは2つの <number> からなる。
<number-optional-number>: A special case of <list of xxx> where there are at least one and at most two entries in the list and the entries are of type <number>.
<angle> (角度):角度は <number> と直後に置く省略可能な角度単位識別子で記述される。角度単位識別子は次のうちいずれかである:
<angle>: An angle value is a <number> optionally followed immediately with an angle unit identifier. Angle unit identifiers are:
ただし、 [CSS2] で定義されるプロパティの値では角度単位識別子が指定されなければならない。 SVG 特有の属性とプロパティでは、角度単位識別子は省略可能である。省略された場合の角度の値は度を表すものとみなされる。
For properties defined in [CSS2], an angle unit identifier must be provided. For SVG-specific attributes and properties, the angle unit identifier is optional. If not provided, the angle value is assumed to be in degrees.
<angle> に対応する SVG DOM インターフェースは SVGAngle または SVGAnimatedAngle である。
The corresponding SVG DOM interface definition for <angle> is an SVGAngle or an SVGAnimatedAngle.
<color>
(色):基本型 <color> の仕様は sRGB 色空間
[SRGB]
については、 CSS2 と互換性がある。 <color> は SVG の
'color'
プロパティとして利用される。また、以下のプロパティ:
'fill',
'stroke',
'stop-color',
'solid-color',
'flood-color',
'lighting-color'
の定義における部品となる。これらのプロパティにおける <color> では、 ICC ベースの色指定も可能である。
(
エラータ
: 'solid-color' はこの仕様には存在しない旧草案の名残。
変更履歴
も参照。)
<color>: The basic type <color> is a CSS2-compatible specification for a color in the sRGB color space [SRGB]. <color> applies to SVG's use of the 'color' property and is a component of the definitions of properties 'fill', 'stroke' 'stop-color', 'solid-color', 'flood-color' and 'lighting-color', which also offer optional ICC-based color specifications.
SVG では <color> に対し、 [CSS2-color-types] で定められた全ての色指定構文がサポートされており、それに加えて SVG による拡張の 識別され得る色キーワード名 もサポートされている。
SVG supports all of the syntax alternatives for <color> defined in [CSS2-color-types] , with the exception that SVG contains an expanded list of recognized color keywords names.
<color> は 色キーワード か RGB の数値で指定される。
A <color> is either a keyword (see Recognized color keyword names) or a numerical RGB specification.
これらの色キーワードに加え、利用者は利用者環境でオブジェクトに用いられる色に対応するキーワードも指定できる。これらキーワードの正式な定義は [CSS2 system colors] に記載されている。
In addition to these color keywords, users may specify keywords that correspond to the colors used by objects in the user's environment. The normative definition of these keywords is [CSS2 system colors].
16 進表記による RGB の数値は '#' に続く3ないし6桁の 16 進数で記述される。3桁の RGB 表記( #rgb )では各桁に0が付加したものではなく、各桁を複写して6桁の形式( #rrggbb )に変換したものとみなされる。例えば #fb0 は #ffbb00 に展開される。これにより白色( #ffffff )は短い表記法( #fff )で指定でき、ディスプレイの色深度に依存することも避けられる。関数表記による RGB の数値は 'rgb(' と ')' で括られるコンマ区切りの3つの数値リスト(3つの整数値か、3つのパーセント値)で記述される。整数値の 255 が 100% あるいは 16 進表記の F または FF に対応する: rgb(255,255,255) = rgb(100%,100%,100%) = #FFF 。空白文字が数値の前後にあってもよい。すべての RGB 色は sRGB 色空間に含まれる( [SRGB] 参照)。 sRGB の利用により、曖昧性のない客観的に計測可能な色の定義が与えられ、国際標準に関連付けられるようになる( [COLORIMETRY] を見よ)。
The format of an RGB value in hexadecimal notation is a '#' immediately followed by either three or six hexadecimal characters. The three-digit RGB notation (#rgb) is converted into six-digit form (#rrggbb) by replicating digits, not by adding zeros. For example, #fb0 expands to #ffbb00. This ensures that white (#ffffff) can be specified with the short notation (#fff) and removes any dependencies on the color depth of the display. The format of an RGB value in the functional notation is 'rgb(' followed by a comma-separated list of three numerical values (either three integer values or three percentage values) followed by ')'. The integer value 255 corresponds to 100%, and to F or FF in the hexadecimal notation: rgb(255,255,255) = rgb(100%,100%,100%) = #FFF. White space characters are allowed around the numerical values. All RGB colors are specified in the sRGB color space (see [SRGB]). Using sRGB provides an unambiguous and objectively measurable definition of the color, which can be related to international standards (see [ COLORIMETRY]).
<color> に対する SVG DOM インターフェースは [DOM2-CSS] で定義される、特に [DOM2-CSS-RGBCOLOR] 参照のこと。 SVG による色の拡張は ICC ベースの色を含み、 DOM インターフェースの SVGColor によって表現される。
The corresponding SVG DOM interface definitions for <color> are defined in [DOM2-CSS]; in particular, see the [ DOM2-CSS-RGBCOLOR]. SVG's extension to color, including the ability to specify ICC-based colors, are represented in DOM interface SVGColor.
<paint> (塗り): 'fill' と 'stroke' プロパティの値は <paint> 型であり、グラフィックス要素の内部や外形線への塗りを行うときに利用される。 <paint> に指定可能なオプションとその構文は 塗りの指定 で述べられる。
<paint> : The values for properties 'fill' and 'stroke' are specifications of the type of paint to use when filling or stroking a given graphics element. The available options and syntax for <paint> are described in Specifying paint.
SVG DOM においては <paint> は SVGPaint で表現される。
Within the SVG DOM, <paint> is represented as an SVGPaint.
<percentage> (パーセント):パーセント値は <number> と直後に置く '%' で記述される。パーセントによる値は常に他の値(例えば長さなど)に対する割合になる。パーセント値を指定可能な属性と プロパティ には、割合の基準となる距離も定義される。
<percentage>: The format of a percentage value is a <number> immediately followed by a '%'. Percentage values are always relative to another value, for example a length. Each attribute or property that allows percentages also defines the reference distance measurement to which the percentage refers.
SVG DOM においては <percentage> は SVGLength か SVGAnimatedLength で表現される。
Within the SVG DOM, a <percentage> is usually represented as an SVGLength or an SVGAnimatedLength.
<transform-list> :<transform-list> の詳細は 利用座標系の変更:transform 属性 で述べられる。
<transform-list> : The detailed description of the possible values for a <transform-list> are detailed in Modifying the User Coordinate System: the transform attribute.
SVG DOM においては <transform-list> は SVGTransformList または SVGAnimatedTransformList として表現される。
Within the SVG DOM, <transform-list> is represented as an SVGTransformList or an SVGAnimatedTransformList.
<uri> (統一リソース識別子 [URI] 参照): URI はウェブ上のリソースの存在位置を特定する。 SVG における URI の仕様は URI 参照 を見よ。
<uri> (Uniform Resource Identifiers [URI] references): A URI is the address of a resource on the Web. For the specification of URI references in SVG, see URI references.
SVG DOM においては <uri> は DOMString または SVGAnimatedString として表現される。
Within the SVG DOM, <uri> is represented as a DOMString or an SVGAnimatedString.
<frequency> (周波数):周波数は聴覚( aural )プロパティとともに利用される。標準の周波数の定義は [CSS2-AURAL] 中に見いだせる。周波数は <number> と直後に置く周波数単位識別子で記述される。周波数単位識別子は以下のいずれかである:
<frequency>: Frequency values are used with aural properties. The normative definition of frequency values can be found in [CSS2-AURAL]. A frequency value is a <number> immediately followed by a frequency unit identifier. Frequency unit identifiers are:
周波数は負であってはならない。
Frequency values may not be negative.
<frequency> に対応する SVG DOM インターフェースは [DOM2-CSS] で定義される。
The corresponding SVG DOM interface definitions for <frequency> are defined in [DOM2-CSS].
<time> (時間):時間の長さは <number> と直後に置く時間単位識別子で記述される。時間単位識別子は次のいずれかである:
<time>: A time value is a <number> immediately followed by a time unit identifier. Time unit identifiers are:
時間の長さは CSS2 のプロパティで使用され、負であってはならない。
Time values are used in CSS properties and may not be negative.
<time> に対応する SVG DOM インターフェースは [DOM2-CSS] で定義される。
The corresponding SVG DOM interface definitions for <time> are defined in [DOM2-CSS].
次に挙げるのは <color> 型で使用できる色キーワードの一覧である。
The following is the list of recognized color keywords that can be used as a keyword value for data type <color>:
|
|
次に挙げるインターフェースが以下で定義される: 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
SVG 言語の要素に直接的に対応するすべての SVG DOM インターフェース(例えば SVGPathElement は 'path' に直接対応している)は基底クラス SVGElement から派生する。
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; };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
型 boolean のアニメーション可能な属性に対し利用される。
interface SVGAnimatedBoolean { attribute boolean baseVal; // raises DOMException on setting readonly attribute boolean animVal; };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
型 DOMString のアニメーション可能な属性に対し利用される。
interface SVGAnimatedString { attribute DOMString baseVal; // raises DOMException on setting readonly attribute DOMString animVal; };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
このインターフェースは DOMString オブジェクトのリストを定義する。
SVGStringList は他の SVGxxxList インターフェースと同じ属性とメソッドを持つ。種々の SVGxxxList インターフェースの実装においては、単一の基底クラスの利用が考えられる。
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 ); };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
in DOMString newItem | リストの唯一の項目となるもの。 |
DOMString | リストに挿入される項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
|
in unsigned long index | リストから返される項目を指定する添字。最初の項目が添字0。 |
DOMString | 指定された項目。 |
DOMException |
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
|
in DOMString newItem | リストに挿入される項目。 | |
in unsigned long index |
この添字の項目の前に新しい項目が挿入される。最初の項目が添字0。 添字が0ならば新しい項目はリストの先頭に挿入される。添字が numberOfItems 以上ならば新しい項目はリストの末尾に挿入される。 |
DOMString | 挿入された項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ 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 のオブジェクト型がリストに合わないときにレイズされる。
|
in unsigned long index | 取り除かれる項目の添字。最初の項目が添字0。 |
DOMString | 取り除かれた項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
|
in DOMString newItem | リストに挿入する項目。最初の項目が添字0。 |
DOMString | 挿入された項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
|
特定の列挙定数のみを値にとるアニメーション可能な属性に対し利用される。
interface SVGAnimatedEnumeration { attribute unsigned short baseVal; // raises DOMException on setting readonly attribute unsigned short animVal; };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
基本型 'integer' を値にとるアニメーション可能な属性に対し利用される。
interface SVGAnimatedInteger { attribute long baseVal; // raises DOMException on setting readonly attribute long animVal; };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
基本型 'number' の属性に対し利用される。
interface SVGNumber { attribute float value; // raises DOMException on setting };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
基本型 'number' を値にとるアニメーション可能な属性に対し利用される。
interface SVGAnimatedNumber { attribute float baseVal; // raises DOMException on setting readonly attribute float animVal; };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
このインターフェースは SVGNumber オブジェクトのリストを定義する。
SVGNumberList は他の SVGxxxList インターフェースと同じ属性とメソッドを持つ。種々の SVGxxxList インターフェースの実装においては、単一の基底クラスの利用が考えられる。
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 ); };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
in SVGNumber newItem | リストの唯一の項目となるもの。 |
SVGNumber | リストに挿入される項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
|
in unsigned long index | リストから返される項目を指定する添字。最初の項目が添字0。 |
SVGNumber | 指定された項目。 |
DOMException |
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
|
in SVGNumber newItem | リストに挿入される項目。 | |
in unsigned long index |
この添字の項目の前に新しい項目が挿入される。最初の項目が添字0。 添字が0ならば新しい項目はリストの先頭に挿入される。添字が numberOfItems 以上ならば新しい項目はリストの末尾に挿入される。 |
SVGNumber | 挿入された項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ 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 のオブジェクト型がリストに合わないときにレイズされる。
|
in unsigned long index | 取り除かれる項目の添字。最初の項目が添字0。 |
SVGNumber | 取り除かれた項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
|
in SVGNumber newItem | リストに挿入する項目。最初の項目が添字0。 |
SVGNumber | 挿入された項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
|
数値のリストを値にとるアニメーション可能な属性に対し利用される。
interface SVGAnimatedNumberList { readonly attribute SVGNumberList baseVal; readonly attribute SVGNumberList animVal; };
SVGLength インターフェースは基本型 <length> に対応する。
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 ); };
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" で指定されている。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
|
DOMException | あてがわれた文字列が有効な <length> に構文解析できない場合にレイズされる。 |
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_* 定数)の場合にレイズされる。
(
エラータ
)
|
in unsigned short unitType | 設定する unitType (例えば SVG_LENGTHTYPE_MM )。 |
DOMException |
DOMException NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NOT_SUPPORTED_ERR: unitType が SVG_LENGTHTYPE_UNKNOWN か、無効な単位型定数(このインターフェースで定義されていない SVG_LENGTHTYPE_* 定数)の場合にレイズされる。
(
エラータ
)
|
基本型 'length' を値にとるアニメーション可能な属性に対し利用される。
interface SVGAnimatedLength { readonly attribute SVGLength baseVal; readonly attribute SVGLength animVal; };
このインターフェースは SVGLength オブジェクトのリストを定義する。
SVGLengthList は他の SVGxxxList インターフェースと同じ属性とメソッドを持つ。種々の SVGxxxList インターフェースの実装においては、単一の基底クラスの利用が考えられる。
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 ); };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
in SVGLength newItem | リストの唯一の項目となるもの。 |
SVGLength | リストに挿入される項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
|
in unsigned long index | リストから返される項目を指定する添字。最初の項目が添字0。 |
SVGLength | 指定された項目。 |
DOMException |
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
|
in SVGLength newItem | リストに挿入される項目。 | |
in unsigned long index |
この添字の項目の前に新しい項目が挿入される。最初の項目が添字0。 添字が0ならば新しい項目はリストの先頭に挿入される。添字が numberOfItems 以上ならば新しい項目はリストの末尾に挿入される。 |
SVGLength | 挿入された項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ 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 のオブジェクト型がリストに合わないときにレイズされる。
|
in unsigned long index | 取り除かれる項目の添字。最初の項目が添字0。 |
SVGLength | 取り除かれた項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
INDEX_SIZE_ERR :添字が負または numberOfItems 以上のときにレイズされる。
|
in SVGLength newItem | リストに挿入する項目。最初の項目が添字0。 |
SVGLength | 挿入された項目。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :リストの変更が許されていないときにレイズされる。
|
|
SVGException |
SVG_WRONG_TYPE_ERR :パラメタ newItem のオブジェクト型がリストに合わないときにレイズされる。
|
型 SVGLengthList のアニメーション可能な属性に対し利用される。
interface SVGAnimatedLengthList { readonly attribute SVGLengthList baseVal; readonly attribute SVGLengthList animVal; };
SVGAngle インターフェースは基本データ型 <angle> に対応する。
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 ); };
SVG_ANGLETYPE_UNKNOWN | タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。 | |
SVG_ANGLETYPE_UNSPECIFIED | 単位タイプが与えられていないことを表す(即ち単位無しの値が指定されている)。角度においては、単位無しの値は単位として度が指定されたものと見なされる。 | |
SVG_ANGLETYPE_DEG | 値の単位が明示的に度に設定されている。 | |
SVG_ANGLETYPE_RAD | 値が単位ラジアンで指定されている。 | |
SVG_ANGLETYPE_GRAD | 値が単位グラードで指定されている。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
|
DOMException | あてがわれた文字列が有効な <angle> に構文解析できない場合にレイズされる。 |
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_* 定数)の場合にレイズされる。
(
エラータ
)
|
in unsigned short unitType | unitType に設定するタイプ(例えば SVG_ANGLETYPE_DEG )。 |
DOMException |
DOMException NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NOT_SUPPORTED_ERR: unitType が SVG_ANGLETYPE_UNKNOWN か、無効な単位型定数(このインターフェースで定義されていない SVG_ANGLETYPE_* 定数)の場合にレイズされる。
(
エラータ
)
|
基本型 'angle' を値にとるアニメーション可能な全てのプロパティと属性に対応する。
interface SVGAnimatedAngle { readonly attribute SVGAngle baseVal; readonly attribute SVGAngle animVal; };
SVGColor インターフェースは 'stop-color', 'flood-color', 'lighting-color' プロパティにおける色値定義に対応し、 SVGPaint の基底クラスである。 これは、 ICC ベースの色指定を組み込んだ SVG の拡張された色の概念を組み込むものである。
SVGColor インターフェースは基本データ型 <color> に対応するものではない。基本データ型 <color> に適用可能な DOM インターフェースは [DOM2-CSS] で定義されている。特に、 [DOM2-CSS-RGBCOLOR] を参照のこと。
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 ); };
SVG_COLORTYPE_UNKNOWN | タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。 | |
SVG_COLORTYPE_RGBCOLOR | sRGB 色が指定されているが代替 ICC 色は指定されていない。 | |
SVG_COLORTYPE_RGBCOLOR_ICCCOLOR | sRGB 色が代替 ICC 色とともに指定されている。 | |
SVG_COLORTYPE_CURRENTCOLOR | キーワード 'currentColor' が指定されている状態に対応する。 |
in DOMString rgbColor | 新しい色値。 |
SVGException |
SVG_INVALID_VALUE_ERR :パラメタのいずれかが無効な値のときにレイズされる。
|
in DOMString rgbColor | 新しい色値。 | |
in DOMString iccColor | 代替 ICC 色の指定。 |
SVGException |
SVG_INVALID_VALUE_ERR :パラメタのいずれかが無効な値のときにレイズされる。
|
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 インターフェースは ICC ベースの色指定を表現する。
interface SVGICCColor { attribute DOMString colorProfile; // raises DOMException on setting readonly attribute SVGNumberList colors; };
ICC 色指定における最初のパラメタである、カラープロファイル名。
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
この ICC 色を定義する色値のリスト。各色値は任意の浮動小数点数。
矩形はXの最小値とYの最小値を指定する座標 (x,y) 、および通常は負にならないよう制約される width と height から定義される。
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 };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :
|
型 SVGRect のアニメーション可能な属性に対し利用される。
interface SVGAnimatedRect { readonly attribute SVGRect baseVal; readonly attribute SVGRect animVal; };
SVGUnitTypes インターフェースは共通して利用される定数を定義し、次のインターフェース: SVGGradientElement, SVGPatternElement, SVGClipPathElement, SVGMaskElement, SVGFilterElement の基底インターフェースとなるものである。
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; };
SVG_UNIT_TYPE_UNKNOWN | タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。 | |
SVG_UNIT_TYPE_USERSPACEONUSE | 値 userSpaceOnUse に対応する。 | |
SVG_UNIT_TYPE_OBJECTBOUNDINGBOX | 値 objectBoundingBox に対応する。 |
interface SVGStylable { readonly attribute SVGAnimatedString className; readonly attribute css::CSSStyleDeclaration style; css::CSSValue getPresentationAttribute ( in DOMString name ); };
in DOMString name | 「プレゼンテーション属性」をその名前から取り出す。 |
css::CSSValue |
与えられたプレゼンテーション属性の静的/基底値を CSSValue として表したもの、または属性に値が指定されていない場合は null 。 |
SVGLocatable インターフェースは transform 属性を持つか、あるいは transform 属性は持たないがその内容が現在の利用空間における包含ボックスを持ち得るような全ての要素に対し利用できる。
interface SVGLocatable { readonly attribute SVGElement nearestViewportElement; readonly attribute SVGElement farthestViewportElement; SVGRect getBBox ( ); SVGMatrix getCTM ( ); SVGMatrix getScreenCTM ( ); SVGMatrix getTransformToElement ( in SVGElement element ) raises( SVGException ); };
SVGRect | 包含ボックスを定義する SVGRect オブジェクト。 |
SVGMatrix | CTM を定義する SVGMatrix オブジェクト。 |
SVGMatrix | 与えられた変換行列を定義する SVGMatrix オブジェクト。 |
element
パラメタで与えられる要素の利用座標系への(その
transform
属性がもしあればその適用後)変換行列を返す。
in SVGElement element | 要素。 |
SVGMatrix | 変換を定義する SVGMatrix オブジェクト。 |
SVGException |
SVG_MATRIX_NOT_INVERTABLE :現在定義されている変換行列たちによる行列の計算が不可能なときレイズされる(例えば1つの変換が特異である
- singular :逆行列を持たない -
などの理由で)。
|
SVGTransformable インターフェースは transform 属性を持つ全ての要素に適用されるプロパティとメソッドを含む。
interface SVGTransformable : SVGLocatable { readonly attribute SVGAnimatedTransformList transform; };
SVGTests インターフェースは requiredFeatures, requiredExtensions, systemLanguage 属性を持つ全ての要素に適用されるインターフェースを定義する。
interface SVGTests { readonly attribute SVGStringList requiredFeatures; readonly attribute SVGStringList requiredExtensions; readonly attribute SVGStringList systemLanguage; boolean hasExtension ( in DOMString extension ); };
in DOMString extension | URI で表記される拡張の名前。 |
boolean | 与えられた拡張がサポートされるかどうかによって true か false を返す。 |
SVGLangSpace インターフェースは xml:lang と xml:space 属性を持つ全ての要素に適用されるインターフェースを定義する。
interface SVGLangSpace { attribute DOMString xmllang; // raises DOMException on setting attribute DOMString xmlspace; // raises DOMException on setting };
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
SVGExternalResourcesRequired インターフェースは要素またはその子孫が外部リソースを参照できるような全ての要素に適用されるインターフェースを定義する。
interface SVGExternalResourcesRequired { readonly attribute SVGAnimatedBoolean externalResourcesRequired; };
SVGFitToViewBox インターフェースは XML 属性 viewBox と preserveAspectRatio を持つ要素に適用される DOM 属性を定義する。
interface SVGFitToViewBox { readonly attribute SVGAnimatedRect viewBox; readonly attribute SVGAnimatedPreserveAspectRatio preserveAspectRatio; };
SVGZoomAndPan インターフェースは "zoomAndPan" 属性および関連する定数を定義する。
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 };
SVG_ZOOMANDPAN_UNKNOWN | タイプが定義済みのものではないことを表す。新しい値にこのタイプを定めたり、既存の値をこのタイプに変更する試みは無効である。 | |
SVG_ZOOMANDPAN_DISABLE | 値 disable に対応する。 | |
SVG_ZOOMANDPAN_MAGNIFY | 値 magnify に対応する。 |
DOMException |
NO_MODIFICATION_ALLOWED_ERR :読み出し専用の属性値の変更を試みたときにレイズされる。
|
このインターフェースは SVG ビュー指定に対応する。
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; };
SVGURIReference インターフェースは xlink:href などの URI 参照を定める一連の XLink 属性を持つ全ての要素に適用されるインターフェースを定義する。
interface SVGURIReference { readonly attribute SVGAnimatedString href; };
SVG では ICC ベースの色指定を可能にするための SVGColorProfileRule 規則を追加して CSSRule インターフェースを SVGCSSRule インターフェースに拡張している。
この拡張は将来版の CSS と DOM の一部となることが見込まれている。
interface SVGCSSRule : css::CSSRule { // Additional CSS RuleType to support ICC color specifications const unsigned short COLOR_PROFILE_RULE = 7; };
COLOR_PROFILE_RULE | 規則が @color-profile である。 |
SVGRenderingIntent インターフェースは 'rendering-intent' 属性および記述に対応する可能な値の列挙を定義する。
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_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 に対応する。 |