SVG11/struct.html

<!DOCTYPE html>
<html lang="ja">
<head>


	<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
	<title title="Document Structure">文書構造 – SVG 1.1 （第２版）</title>
	<link rel="stylesheet" type="text/css" media="screen" href="style/svg-style.css">
	<link rel="stylesheet" href="style/W3C-REC.css">
</head><body>

<div class="header top">
<a href="index.html#minitoc">目次</a> ⋅
<a href="expanded-toc.html">詳細目次</a> ⋅
<a href="types.html">前章</a> ⋅
<a href="styling.html">次章</a> ⋅
<a href="eltindex.html">要素</a> ⋅
<a href="attindex.html">属性</a> ⋅
<a href="propidx.html">プロパティ</a>
</div>

<h1 title="5 Document Structure">5 文書構造</h1>

<h2 title="Contents" id="toc">目次</h2>

<ul class="toc">
<li><a title="5.1 Defining an SVG document fragment: the ‘svg’ element" href="#NewDocument">
5.1 SVG 文書片を定義する： <span class="element-name">svg</span> 要素</a>
<ul class="toc">
<li><a title="5.1.1 Overview" href="#NewDocumentOverview">
5.1.1 概観</a></li>
<li><a title="5.1.2 The ‘svg’ element" href="#SVGElement">
5.1.2 <span class="element-name">svg</span> 要素</a></li>
</ul></li>
<li><a title="5.2 Grouping: the ‘g’ element" href="#Groups">
5.2 グループ化：<span class="element-name">g</span> 要素</a>
<ul class="toc">
<li><a title="5.2.1 Overview" href="#GroupsOverview">
5.2.1 概観</a></li>
<li><a title="5.2.2 The ‘g’ element" href="#GElement">
5.2.2 <span class="element-name">g</span> 要素</a></li>
</ul></li>
<li><a title="5.3 Defining content for reuse, and the ‘defs’ element" href="#Head">
5.3 再利用可能な内容の定義と <span class="element-name">defs</span> 要素</a>
<ul class="toc">
<li><a title="5.3.1 Overview" href="#Overview">
5.3.1 概観</a></li>
<li><a title="5.3.2 The ‘defs’ element" href="#DefsElement">
5.3.2 <span class="element-name">defs</span> 要素</a></li>
</ul></li>
<li><a title="5.4 The ‘desc’ and ‘title’ elements" href="#DescriptionAndTitleElements">
5.4 <span class="element-name">desc</span> 要素と <span class="element-name">title</span> 要素</a></li>
<li><a title="5.5 The ‘symbol’ element" href="#SymbolElement">
5.5 <span class="element-name">symbol</span> 要素</a></li>
<li><a title="5.6 The ‘use’ element" href="#UseElement">
5.6 <span class="element-name">use</span> 要素</a></li>
<li><a title="5.7 The ‘image’ element" href="#ImageElement">
5.7 <span class="element-name">image</span> 要素</a></li>
<li><a title="5.8 Conditional processing" href="#ConditionalProcessing">
5.8 条件付き処理</a>
<ul class="toc">
<li><a title="5.8.1 Conditional processing overview" href="#ConditionalProcessingOverview">
5.8.1 条件付き処理の概観</a></li>
<li><a title="5.8.2 The ‘switch’ element" href="#SwitchElement">
5.8.2 <span class="element-name">switch</span> 要素</a></li>
<li><a title="5.8.3 The ‘requiredFeatures’ attribute" href="#ConditionalProcessingRequiredFeaturesAttribute">
5.8.3 <span class="attr-name">requiredFeatures</span> 属性</a></li>
<li><a title="5.8.4 The ‘requiredExtensions’ attribute" href="#ConditionalProcessingRequiredExtensionsAttribute">
5.8.4 <span class="attr-name">requiredExtensions</span> 属性</a></li>
<li><a title="5.8.5 The ‘systemLanguage’ attribute" href="#ConditionalProcessingSystemLanguageAttribute">
5.8.5 <span class="attr-name">systemLanguage</span> 属性</a></li>
<li><a title="5.8.6 Applicability of test attributes" href="#ApplicabilityOfTestAttributes">
5.8.6 テスト属性の適用性</a></li>
</ul></li>
<li><a title="5.9 Specifying whether external resources are required for proper rendering" href="#ExternalResourcesRequired">
5.9 文書の正当な描画に欠かせない外部リソースの指定</a></li>
<li><a title="5.10 Common attributes" href="#CommonAttributes">
5.10 共通属性</a>
<ul class="toc">
<li><a title="5.10.1 Attributes common to all elements: ‘id’ and ‘xml:base’" href="#Core.attrib">
5.10.1 すべての要素に共通の属性： <span class="attr-name">id</span> と <span class="attr-name">xml:base</span></a></li>
<li><a title="5.10.2 The ‘xml:lang’ and ‘xml:space’ attributes" href="#LangSpaceAttrs">
5.10.2 <span class="attr-name">xml:lang</span> 属性と <span class="attr-name">xml:space</span> 属性</a></li>
</ul></li>
<li><a title="5.11 DOM interfaces" href="#DOMInterfaces">
5.11 DOM インタフェース</a>
<ul class="toc">
<li><a title="5.11.1 Interface SVGDocument" href="#InterfaceSVGDocument">
5.11.1 インタフェース SVGDocument</a></li>
<li><a title="5.11.2 Interface SVGSVGElement" href="#InterfaceSVGSVGElement">
5.11.2 インタフェース SVGSVGElement</a></li>
<li><a title="5.11.3 Interface SVGGElement" href="#InterfaceSVGGElement">
5.11.3 インタフェース SVGGElement</a></li>
<li><a title="5.11.4 Interface SVGDefsElement" href="#InterfaceSVGDefsElement">
5.11.4 インタフェース SVGDefsElement</a></li>
<li><a title="5.11.5 Interface SVGDescElement" href="#InterfaceSVGDescElement">
5.11.5 インタフェース SVGDescElement</a></li>
<li><a title="5.11.6 Interface SVGTitleElement" href="#InterfaceSVGTitleElement">
5.11.6 インタフェース SVGTitleElement</a></li>
<li><a title="5.11.7 Interface SVGSymbolElement" href="#InterfaceSVGSymbolElement">
5.11.7 インタフェース SVGSymbolElement</a></li>
<li><a title="5.11.8 Interface SVGUseElement" href="#InterfaceSVGUseElement">
5.11.8 インタフェース SVGUseElement</a></li>
<li><a title="5.11.9 Interface SVGElementInstance" href="#InterfaceSVGElementInstance">
5.11.9 インタフェース SVGElementInstance</a></li>
<li><a title="5.11.10 Interface SVGElementInstanceList" href="#InterfaceSVGElementInstanceList">
5.11.10 インタフェース SVGElementInstanceList</a></li>
<li><a title="5.11.11 Interface SVGImageElement" href="#InterfaceSVGImageElement">
5.11.11 インタフェース SVGImageElement</a></li>
<li><a title="5.11.12 Interface SVGSwitchElement" href="#InterfaceSVGSwitchElement">
5.11.12 インタフェース SVGSwitchElement</a></li>
<li><a title="5.11.13 Interface GetSVGDocument" href="#InterfaceGetSVGDocument">
5.11.13 インタフェース GetSVGDocument</a></li></ul></li>
</ul>


<h2 title="5.1 Defining an SVG document fragment: the ‘svg’ element" id="NewDocument">5.1 SVG 文書片を定義する： <span class="element-name">svg</span> 要素</h2>


<h3 title="5.1.1 Overview" id="NewDocumentOverview">5.1.1 概観</h3>

<p class="T">
<a href="intro.html#TermSVGDocumentFragment"><span class="svg-term">SVG 文書片</span></a>
は
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素とその中に含められる任意個数の SVG 要素から構成される。
<span lang="en">
An SVG document fragment consists of any number of SVG elements contained within an ‘svg’ element.
</span></p>

<p class="T">
SVG 文書片は、空のもの（すなわち
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
の中に何も含まれていないもの）,
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>,
などの
<a href="intro.html#TermGraphicsElement"><span class="svg-term">グラフィックス要素</span></a>
をただ一つ含むごく単純なものから，
<a href="intro.html#TermContainerElement"><span class="svg-term">コンテナ要素</span></a>
と
<a href="intro.html#TermGraphicsElement"><span class="svg-term">グラフィックス要素</span></a>
から構築される複雑で深い入れ子構造を持つものまでになり得る。
<span lang="en">
An SVG document fragment can range from an empty fragment (i.e., no content inside of the ‘svg’ element), to a very simple SVG document fragment containing a single SVG graphics element such as a ‘rect’, to a complex, deeply nested collection of container elements and graphics elements.
</span></p>

<p class="T">
SVG 文書片は、それ自身が独立した ファイルやリソースになれる。
その場合は
<a href="intro.html#TermSVGDocumentFragment"><span class="svg-term">SVG 文書</span></a>
になる。
あるいは、親の XML 文書内に文書片としてインラインに埋め込むこともできる。
<span lang="en">
An SVG document fragment can stand by itself as a self-contained file or resource, in which case the SVG document fragment is an SVG document, or it can be embedded inline as a fragment within a parent XML document.
</span></p>

<p class="T" id="EmbeddedSVGExample">
下に、親の XML 文書内に文書片として埋め込まれている簡単な SVG 内容の例を示す。
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素と
<a href="shapes.html#EllipseElement"><span class="element-name">ellipse</span></a>
要素が SVG 名前空間に属することを指示するため、 XML 名前空間が利用されていることに注意：
<span lang="en">
The following example shows simple SVG content embedded inline as a fragment within a parent XML document. Note the use of XML namespaces to indicate that the ‘svg’ and ‘ellipse’ elements belong to the SVG namespace:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="yes"?&gt;
&lt;parent xmlns="http://example.org"
        xmlns:svg="http://www.w3.org/2000/svg"&gt;
   &lt;!-- <span title="parent contents here">親の内容はここに</span> --&gt;
   &lt;svg:svg width="4cm" height="8cm" version="1.1"&gt;
      &lt;svg:ellipse cx="2cm" cy="4cm" rx="2cm" ry="1cm" /&gt;
   &lt;/svg:svg&gt;
   &lt;!-- ... --&gt;
&lt;/parent&gt;
</pre>

<p class="T">
次の例は少し複雑なもの（いくつかの矩形が含まれている）。
独立した 外部依存のない SVG 文書になっている：
<span lang="en">
This example shows a slightly more complex (i.e., it contains multiple rectangles) stand-alone, self-contained SVG document:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="5cm" height="4cm" version="1.1"
     xmlns="http://www.w3.org/2000/svg"&gt;
  &lt;desc&gt;<span title="Four separate rectangles">４個の別々の矩形</span>
  &lt;/desc&gt;
    &lt;rect x="0.5cm" y="0.5cm" width="2cm" height="1cm"/&gt;
    &lt;rect x="0.5cm" y="2cm" width="1cm" height="1.5cm"/&gt;
    &lt;rect x="3cm" y="0.5cm" width="1.5cm" height="2cm"/&gt;
    &lt;rect x="3.5cm" y="3cm" width="1cm" height="0.5cm"/&gt;

  &lt;!-- <span title="Show outline of canvas using 'rect' element">要素でキャンバスの境界を表示</span> --&gt;
  &lt;rect x=".01cm" y=".01cm" width="4.98cm" height="3.98cm"
        fill="none" stroke="blue" stroke-width=".02cm" /&gt;

&lt;/svg&gt;</pre>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素は SVG 内容の中に現れてもよい。
これが、他の SVG 文書片を SVG 文書片の中に埋め込むための仕組みになる。
<span lang="en">
‘svg’ elements can appear in the middle of SVG content. This is the mechanism by which SVG document fragments can be embedded within other SVG document fragments.
</span></p>

<p class="T">
SVG 内容の中における
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の別の用途は、新たなビューポートを確立させることである（
<a href="coords.html#EstablishingANewViewport">新たなビューポートの確立</a>
を見よ）。
<span lang="en">
Another use for ‘svg’ elements within the middle of SVG content is to establish a new viewport. (See Establishing a new viewport.)
</span></p>

<p class="T">
いかなる場合でも、すべての SVG 要素が SVG 名前空間に属するものと識別されるようにするためには，
<a href="http://www.w3.org/TR/2006/REC-xml-names-20060816/"><cite>XML 名前空間</cite></a>
勧告
[<a href="refs.html#ref-XML-NS">XML-NS</a>]
に従って SVG 名前空間宣言が与えられなければならない。
以下は SVG 名前空間宣言として可能な記法になる。
名前空間接頭辞の無い <span class="attr-name">xmlns</span> 属性を
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に指定した場合、そのスコープ下に入るすべての要素の既定の名前空間が SVG になる：
<span lang="en">
In all cases, for compliance with the Namespaces in XML Recommendation [XML-NS], an SVG namespace declaration must be provided so that all SVG elements are identified as belonging to the SVG namespace. The following are possible ways to provide a namespace declaration. An ‘xmlns’ attribute without a namespace prefix could be specified on an ‘svg’ element, which means that SVG is the default namespace for all elements within the scope of the element with the ‘xmlns’ attribute:
</span></p>


<pre class="xml">&lt;svg xmlns="http://www.w3.org/2000/svg" …&gt;
  &lt;rect …/&gt;
&lt;/svg&gt;
</pre>

<p class="T">
<span class="attr-name">xmlns</span> 属性に名前空間接頭辞を付けた場合（例えば <code class="xml">xmlns:svg="http://www.w3.org/2000/svg"</code> ）、対応する名前空間は既定の名前空間にはならないので、要素すべてに名前空間接頭辞を与えなければならない：
<span lang="en">
If a namespace prefix is specified on the ‘xmlns’ attribute (e.g., xmlns:svg="http://www.w3.org/2000/svg"), then the corresponding namespace is not the default namespace, so an explicit namespace prefix must be assigned to the elements:
</span></p>


<pre class="xml">&lt;svg:svg xmlns:svg="http://www.w3.org/2000/svg" …&gt;
  &lt;svg:rect …/&gt;
&lt;/svg:svg&gt;
</pre>

<p class="T">
名前空間接頭辞は先祖要素に指定することもできる（
<a href="#EmbeddedSVGExample">上の例</a>
に示されている）。
詳細は
<a href="http://www.w3.org/TR/2006/REC-xml-names-20060816/"><cite>XML 名前空間</cite></a>
勧告
[<a href="refs.html#ref-XML-NS">XML-NS</a>]
を参照のこと。
<span lang="en">
Namespace prefixes can be specified on ancestor elements (illustrated in the above example). For more information, refer to the Namespaces in XML Recommendation [XML-NS].
</span></p>


<h3 title="5.1.2 The ‘svg’ element" id="SVGElement">5.1.2 <span class="element-name">svg</span> 要素</h3>

<div class="element-summary"><div class="element-summary-name"><span class="element-name">svg</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermContainerElement">コンテナ要素</a>,
<a href="intro.html#TermStructuralElement">構造要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
<li><a class="T-ex" href="intro.html#TermShapeElement">図形要素</a></li>
<li><a class="T-ex" href="intro.html#TermStructuralElement">構造要素</a></li>
<li><a class="T-ex" href="intro.html#TermGradientElement">グラデーション要素</a></li>
<li><a href="linking.html#AElement"><span class="element-name">a</span></a></li><li><a href="text.html#AltGlyphDefElement"><span class="element-name">altGlyphDef</span></a></li><li><a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a></li><li><a href="color.html#ColorProfileElement"><span class="element-name">color-profile</span></a></li><li><a href="interact.html#CursorElement"><span class="element-name">cursor</span></a></li><li><a href="filters.html#FilterElement"><span class="element-name">filter</span></a></li><li><a href="fonts.html#FontElement"><span class="element-name">font</span></a></li><li><a href="fonts.html#FontFaceElement"><span class="element-name">font-face</span></a></li><li><a href="extend.html#ForeignObjectElement"><span class="element-name">foreignObject</span></a></li><li><a href="struct.html#ImageElement"><span class="element-name">image</span></a></li><li><a href="painting.html#MarkerElement"><span class="element-name">marker</span></a></li><li><a href="masking.html#MaskElement"><span class="element-name">mask</span></a></li><li><a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a></li><li><a href="script.html#ScriptElement"><span class="element-name">script</span></a></li><li><a href="styling.html#StyleElement"><span class="element-name">style</span></a></li><li><a href="struct.html#SwitchElement"><span class="element-name">switch</span></a></li><li><a href="text.html#TextElement"><span class="element-name">text</span></a></li><li><a href="linking.html#ViewElement"><span class="element-name">view</span></a></li></ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermConditionalProcessingAttribute">条件付き処理属性</a></li>
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermDocumentEventAttribute">文書イベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="struct.html#SVGElementXAttribute"><span class="attr-name">x</span></a></li><li><a href="struct.html#SVGElementYAttribute"><span class="attr-name">y</span></a></li><li><a href="struct.html#SVGElementWidthAttribute"><span class="attr-name">width</span></a></li><li><a href="struct.html#SVGElementHeightAttribute"><span class="attr-name">height</span></a></li><li><a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a></li><li><a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a></li><li><a href="interact.html#ZoomAndPanAttribute"><span class="attr-name">zoomAndPan</span></a></li><li><a href="struct.html#SVGElementVersionAttribute"><span class="attr-name">version</span></a></li><li><a href="struct.html#SVGElementBaseProfileAttribute"><span class="attr-name">baseProfile</span></a></li><li><a href="script.html#ContentScriptTypeAttribute"><span class="attr-name">contentScriptType</span></a></li><li><a href="styling.html#ContentStyleTypeAttribute"><span class="attr-name">contentStyleType</span></a></li><li><a href="struct.html#SVGElementXAttribute"><span class="attr-name">x</span></a></li><li><a href="struct.html#SVGElementYAttribute"><span class="attr-name">y</span></a></li><li><a href="struct.html#SVGElementWidthAttribute"><span class="attr-name">width</span></a></li><li><a href="struct.html#SVGElementHeightAttribute"><span class="attr-name">height</span></a></li><li><a href="struct.html#SVGElementVersionAttribute"><span class="attr-name">version</span></a></li><li><a href="struct.html#SVGElementBaseProfileAttribute"><span class="attr-name">baseProfile</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a></li></ul></dd></dl></div>

  
<div class="adef-list">
  <p><em>属性定義</em></p>
  <dl><dt id="SVGElementVersionAttribute"><span class="adef">version</span> = "<a href="types.html#DataTypeNumber"><span class="attr-value">&lt;number&gt;</span></a>"</dt><dd>

<p class="T">
文書が準拠する SVG 言語のバージョンを指定する。
<span lang="en">
Indicates the SVG language version to which this document fragment conforms.
</span></p>


<p class="T">
<a href="http://www.w3.org/TR/2001/REC-SVG-20010904/">SVG 1.0</a>
[<a href="refs.html#ref-SVG10">SVG10</a>]
ではこの属性は <span class="attr-value">'1.0'</span> に固定されている。
SVG 1.1 では <span class="attr-value">'1.1'</span> とすべきである。
<span lang="en">
In SVG 1.0 [SVG10], this attribute was fixed to the value '1.0'. For SVG 1.1, the attribute should have the value '1.1'.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd><dt id="SVGElementBaseProfileAttribute"><span class="adef">baseProfile</span> = profile-name</dt><dd>

<p class="T">
文書作成者が内容の正確な描画に最小限必要と考える SVG 言語プロファイルをここで指定する。
この属性は処理における制約を規定するわけではなく、メタデータと見なしてよい。
例えば、利用者がここで指定した基本プロファイルの枠を越えて文書を編集しようとした際に，文書作成ツールから警告を発するための利用がある。
それぞれの SVG 言語プロファイルは、この属性に与える適切なテキストを定義すべきである。
<span lang="en">
Describes the minimum SVG language profile that the author believes is necessary to correctly render the content. The attribute does not specify any processing restrictions; It can be considered metadata. For example, the value of the attribute could be used by an authoring tool to warn the user when they are modifying the document beyond the scope of the specified base profile. Each SVG profile should define the text that is appropriate for this attribute.
</span></p>

<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">none</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of 'none' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd><dt id="SVGElementXAttribute"><span class="adef">x</span> = "<a href="types.html#DataTypeCoordinate"><span class="attr-value">&lt;coordinate&gt;</span></a>"</dt><dd>

<p class="T">
（
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に対しては、どんな意味も効果も生じない。）
<span lang="en">
(Has no meaning or effect on outermost svg elements.)
</span></p>


<p class="T">
埋め込まれる
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素が配置される領域矩形の第一頂点の X 座標。
<span lang="en">
The x-axis coordinate of one corner of the rectangular region into which an embedded ‘svg’ element is placed.
</span></p>

<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">0</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of '0' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="SVGElementYAttribute"><span class="adef">y</span> = "<a href="types.html#DataTypeCoordinate"><span class="attr-value">&lt;coordinate&gt;</span></a>"</dt><dd>

<p class="T">
（
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に対しては、どんな意味も効果も生じない。）
<span lang="en">
(Has no meaning or effect on outermost svg elements.)
</span></p>


<p class="T">
埋め込まれる
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素が配置される領域矩形の第一頂点の Y 座標。
<span lang="en">
The y-axis coordinate of one corner of the rectangular region into which an embedded ‘svg’ element is placed.
</span></p>

<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">0</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of '0' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="SVGElementWidthAttribute"><span class="adef">width</span> = "<a href="types.html#DataTypeLength"><span class="attr-value">&lt;length&gt;</span></a>"</dt><dd>

<p class="T">
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に対しては、 SVG 文書片の固有の横幅を意味する。
埋め込まれる
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に対しては、配置されるときの矩形の横幅を意味する。
<span lang="en">
For outermost svg elements, the intrinsic width of the SVG document fragment. For embedded ‘svg’ elements, the width of the rectangular region into which the ‘svg’ element is placed.
</span></p>

<p class="T">
負値はエラー（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
値をゼロにすると要素は描画されなくなる。
<span lang="en">
A negative value is an error (see Error processing). A value of zero disables rendering of the element.
</span></p>


<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">'100%'</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of '100%' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="SVGElementHeightAttribute"><span class="adef">height</span> = "<a href="types.html#DataTypeLength"><span class="attr-value">&lt;length&gt;</span></a>"</dt><dd>

<p class="T">
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に対しては、 SVG 文書片の固有の高さを意味する。
埋め込まれる
<span class="element-name">svg</span>
要素に対しては、配置されるときの矩形の高さを意味する。
<span lang="en">
For outermost svg elements, the intrinsic height of the SVG document fragment. For embedded ‘svg’ elements, the height of the rectangular region into which the ‘svg’ element is placed.
</span></p>


<p class="T">
負値はエラー（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
値をゼロにすると要素は描画されなくなる。
<span lang="en">
A negative value is an error (see Error processing). A value of zero disables rendering of the element.
</span></p>


<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">'100%'</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of '100%' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="SVGElementPreserveAspectRatioAttribute">
      <span class="adef">preserveAspectRatio</span> = "<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-value">[defer] &lt;align&gt; [&lt;meetOrSlice&gt;]</span></a>"
    </dt><dd>

<p class="T">
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
を見よ。
<span lang="en">
See ‘preserveAspectRatio’.
</span></p>

<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">'xMidYMid meet'</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, then the effect is as if a value of 'xMidYMid meet' were specified.
</span></p>

<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

    </dd><dt id="SVGElementContentScriptTypeAttribute">
      <span class="adef">contentScriptType</span> = "<span class="attr-value"><a href="script.html#ContentScriptTypeAttribute"><em>content-type</em></a></span>"
    </dt><dd>

<p class="T">
<a href="script.html#ContentScriptTypeAttribute"><span class="attr-name">contentScriptType</span></a>
を見よ。
<span lang="en">
See 'contentScriptType'.
</span></p>

    </dd><dt id="SVGElementContentStyleTypeAttribute">
      <span class="adef">contentStyleType</span> = "<span class="attr-value"><a href="styling.html#ContentStyleTypeAttribute"><em>content-type</em></a></span>"
    </dt><dd>

<p class="T">
<a href="styling.html#ContentStyleTypeAttribute"><span class="attr-name">contentStyleType</span></a>
を見よ。
<span lang="en">
See 'contentStyleType'.
</span></p>

    </dd><dt id="SVGElementZoomAndPanAttribute">
      <span class="adef">zoomAndPan</span> = "<a href="interact.html#ZoomAndPanAttribute"><span class="attr-value">disable | magnify</span></a>"
    </dt><dd>

<p class="T">
<a href="interact.html#ZoomAndPanAttribute"><span class="attr-name">zoomAndPan</span></a>
を見よ。
<span lang="en">
See 'zoomAndPan'.
</span></p>

    </dd></dl>
</div>

<p class="T">
他の文書の部品として参照されることが予期される SVG 文書においては、
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に
<a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a>
属性を指定するとよい。
この属性は、 SVG 文書を任意のビューポートに適宜倍率を変えてはめ込む簡便な方法を提供する。
<span lang="en">
If an SVG document is likely to be referenced as a component of another document, the author will often want to include a ‘viewBox’ attribute on the outermost svg element of the referenced document. This attribute provides a convenient way to design SVG documents to scale-to-fit into an arbitrary viewport.
</span></p>


<h2 title="5.2 Grouping: the ‘g’ element" id="Groups">5.2 グループ化：<span class="element-name">g</span> 要素</h2>

<h3 title="5.2.1 Overview" id="GroupsOverview">5.2.1 概観</h3>

<p class="T">
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素は、互いに関連する
<a href="intro.html#TermGraphicsElement"><span class="svg-term">グラフィックス要素</span></a>
をグループ化するための
<a href="intro.html#TermContainerElement"><span class="svg-term">コンテナ要素</span></a>
である。
<span lang="en">
The ‘g’ element is a container element for grouping together related graphics elements.
</span></p>

<p class="T">
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
要素と
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素とグループ化との併用により、文書構造と意味論の情報が与えられるようになる。
多彩な構造を備える文書は、スピーチ, 点字, あるいはグラフィックによる出力が可能になり，
<a href="access.html">アクセシビリティ</a>
も向上する。
<span lang="en">
Grouping constructs, when used in conjunction with the ‘desc’ and ‘title’ elements, provide information about document structure and semantics. Documents that are rich in structure may be rendered graphically, as speech, or as braille, and thus promote accessibility.
</span></p>

<p class="T">
グループ化された要素に対しても、個々のオブジェクトと同様に
<a href="struct.html#IDAttribute"><span class="attr-name">id</span></a>
属性を用いて名前を付けられる。
名前付きのグループは、アニメーションや再利用など，様々な局面で必要になる。
<span lang="en">
A group of elements, as well as individual objects, can be given a name using the ‘id’ attribute. Named groups are needed for several purposes such as animation and re-usable objects.
</span></p>

<p class="T">
例：
<span lang="en">
An example:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg xmlns="http://www.w3.org/2000/svg"
     version="1.1" width="5cm" height="5cm"&gt;
  &lt;desc&gt;<span title="Two groups, each of two rectangles">それぞれ２個の矩形からなる２つのグループ</span>&lt;/desc&gt;
  &lt;g id="group1" fill="red"&gt;
    &lt;rect x="1cm" y="1cm" width="1cm" height="1cm"/&gt;
    &lt;rect x="3cm" y="1cm" width="1cm" height="1cm"/&gt;
  &lt;/g&gt;
  &lt;g id="group2" fill="blue"&gt;
    &lt;rect x="1cm" y="3cm" width="1cm" height="1cm"/&gt;
    &lt;rect x="3cm" y="3cm" width="1cm" height="1cm"/&gt;
  &lt;/g&gt;

  &lt;!-- <span title="Show outline of canvas using 'rect' element">'rect' 要素でキャンバスの境界を表示</span> --&gt;
  &lt;rect x=".01cm" y=".01cm" width="4.98cm" height="4.98cm"
        fill="none" stroke="blue" stroke-width=".02cm"/&gt;
&lt;/svg&gt;</pre>
<p class="view-as-svg"><a href="images/struct/grouping01.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素は、他の
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素を任意の階層にわたって入れ子にできる。
下の例のように：
<span lang="en">
A ‘g’ element can contain other ‘g’ elements nested within it, to an arbitrary depth. Thus, the following is possible:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg xmlns="http://www.w3.org/2000/svg"
     version="1.1" width="4in" height="3in"&gt;
  &lt;desc&gt;<span title="Groups can nest">グループは入れ子にできる</span>&lt;/desc&gt;
  &lt;g&gt;
     &lt;g&gt;
       &lt;g&gt;
       &lt;/g&gt;
     &lt;/g&gt;
   &lt;/g&gt;
&lt;/svg&gt;
</pre>

<p class="T">
<a href="struct.html#GElement"><span class="element-name">g</span></a>
に含まれていないどの要素も、（少なくとも概念的には）あたかも単独でグループをなすものとして扱われる。
<span lang="en">
Any element that is not contained within a ‘g’ is treated (at least conceptually) as if it were in its own group.
</span></p>


<h3 title="5.2.2 The ‘g’ element" id="GElement">5.2.2 <span class="element-name">g</span> 要素</h3>

<div class="element-summary"><div class="element-summary-name"><span class="element-name">g</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermContainerElement">コンテナ要素</a>,
<a href="intro.html#TermStructuralElement">構造要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
<li><a class="T-ex" href="intro.html#TermShapeElement">図形要素</a></li>
<li><a class="T-ex" href="intro.html#TermStructuralElement">構造要素</a></li>
<li><a class="T-ex" href="intro.html#TermGradientElement">グラデーション要素</a></li>
<li><a href="linking.html#AElement"><span class="element-name">a</span></a></li><li><a href="text.html#AltGlyphDefElement"><span class="element-name">altGlyphDef</span></a></li><li><a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a></li><li><a href="color.html#ColorProfileElement"><span class="element-name">color-profile</span></a></li><li><a href="interact.html#CursorElement"><span class="element-name">cursor</span></a></li><li><a href="filters.html#FilterElement"><span class="element-name">filter</span></a></li><li><a href="fonts.html#FontElement"><span class="element-name">font</span></a></li><li><a href="fonts.html#FontFaceElement"><span class="element-name">font-face</span></a></li><li><a href="extend.html#ForeignObjectElement"><span class="element-name">foreignObject</span></a></li><li><a href="struct.html#ImageElement"><span class="element-name">image</span></a></li><li><a href="painting.html#MarkerElement"><span class="element-name">marker</span></a></li><li><a href="masking.html#MaskElement"><span class="element-name">mask</span></a></li><li><a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a></li><li><a href="script.html#ScriptElement"><span class="element-name">script</span></a></li><li><a href="styling.html#StyleElement"><span class="element-name">style</span></a></li><li><a href="struct.html#SwitchElement"><span class="element-name">switch</span></a></li><li><a href="text.html#TextElement"><span class="element-name">text</span></a></li><li><a href="linking.html#ViewElement"><span class="element-name">view</span></a></li></ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermConditionalProcessingAttribute">条件付き処理属性</a></li>
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGGElement">SVGGElement</a></li></ul></dd></dl></div>

<h2 title="5.3 Defining content for reuse, and the ‘defs’ element" id="Head">5.3 再利用可能な内容の定義と <span class="element-name">defs</span> 要素</h2>

<h3 title="5.3.1 Overview" id="Overview">5.3.1 概観</h3>

<p class="T">
SVG では、後で再利用するためのグラフィカルなオブジェクトを定義できる。
そのために、広範囲に渡り，他のオブジェクトへの
<a href="intro.html#TermIRIReference"><span class="svg-term">IRI 参照</span></a>
[<a href="refs.html#ref-RFC3987">RFC3987</a>]
が利用できるようにされている。
例えば 矩形を線型グラデーションで塗りつぶす場合、まず次の様に
<a href="pservers.html#LinearGradientElement"><span class="element-name">linearGradient</span></a>
要素を定義して ID を与える：
<span lang="en">
SVG allows graphical objects to be defined for later reuse. To do this, it makes extensive use of IRI references [RFC3987] to these other objects. For example, to fill a rectangle with a linear gradient, you first define a ‘linearGradient’ element and give it an ID, as in:
</span></p>


<pre class="xml">&lt;linearGradient id="MyGradient"&gt;...&lt;/linearGradient&gt;
</pre>

<p class="T">
次に、矩形の
<a href="painting.html#FillProperty"><span class="prop-name">fill</span></a>
プロパティに，この線型グラデーションへの参照を与える：
<span lang="en">
You then reference the linear gradient as the value of the ‘fill’ property for the rectangle, as in:
</span></p>


<pre class="xml">&lt;rect style="fill:url(#MyGradient)"/&gt;
</pre>

<p class="T">
グラデーションなどの一部の型の要素は、それ自身は描画内容を生成しない。
それらは都合の良い任意の場所に配置できる。
しかしながら、グラフィカルなオブジェクトを直接描画させずに，参照からのみに利用したい場合もある。
これを行うため，および 定義済み内容の簡便なグループ化のため、 SVG には
<span class="element-name">defs</span>
要素が用意されている。
<span lang="en">
Some types of element, such as gradients, will not by themselves produce a graphical result. They can therefore be placed anywhere convenient. However, sometimes it is desired to define a graphical object and prevent it from being directly rendered. it is only there to be referenced elsewhere. To do this, and to allow convenient grouping defined content, SVG provides the ‘defs’ element.
</span></p>

<p class="T">
参照先の要素は、可能な限り
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素内に定義することが推奨される。
常に参照を通して利用される要素は：
<a href="text.html#AltGlyphDefElement"><span class="element-name">altGlyphDef</span></a>,
<a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a>,
<a href="interact.html#CursorElement"><span class="element-name">cursor</span></a>,
<a href="filters.html#FilterElement"><span class="element-name">filter</span></a>,
<a href="pservers.html#LinearGradientElement"><span class="element-name">linearGradient</span></a>,
<a href="painting.html#MarkerElement"><span class="element-name">marker</span></a>,
<a href="masking.html#MaskElement"><span class="element-name">mask</span></a>,
<a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a>,
<a href="pservers.html#RadialGradientElement"><span class="element-name">radialGradient</span></a>,
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
である。
これらの要素は
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素内で定義した方が文書内容も理解し易くなり、アクセシビリティも向上する。
<span lang="en">
It is recommended that, wherever possible, referenced elements be defined inside of a ‘defs’ element. Among the elements that are always referenced: ‘altGlyphDef’, ‘clipPath’, ‘cursor’, ‘filter’, ‘linearGradient’, ‘marker’, ‘mask’, ‘pattern’, ‘radialGradient’ and ‘symbol’. Defining these elements inside of a ‘defs’ element promotes understandability of the SVG content and thus promotes accessibility.
</span></p>


<h3 title="5.3.2 The ‘defs’ element" id="DefsElement">5.3.2 <span class="element-name">defs</span> 要素</h3>

<div class="element-summary"><div class="element-summary-name"><span class="element-name">defs</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermContainerElement">コンテナ要素</a>,
<a href="intro.html#TermStructuralElement">構造要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
<li><a class="T-ex" href="intro.html#TermShapeElement">図形要素</a></li>
<li><a class="T-ex" href="intro.html#TermStructuralElement">構造要素</a></li>
<li><a class="T-ex" href="intro.html#TermGradientElement">グラデーション要素</a></li>
<li><a href="linking.html#AElement"><span class="element-name">a</span></a></li><li><a href="text.html#AltGlyphDefElement"><span class="element-name">altGlyphDef</span></a></li><li><a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a></li><li><a href="color.html#ColorProfileElement"><span class="element-name">color-profile</span></a></li><li><a href="interact.html#CursorElement"><span class="element-name">cursor</span></a></li><li><a href="filters.html#FilterElement"><span class="element-name">filter</span></a></li><li><a href="fonts.html#FontElement"><span class="element-name">font</span></a></li><li><a href="fonts.html#FontFaceElement"><span class="element-name">font-face</span></a></li><li><a href="extend.html#ForeignObjectElement"><span class="element-name">foreignObject</span></a></li><li><a href="struct.html#ImageElement"><span class="element-name">image</span></a></li><li><a href="painting.html#MarkerElement"><span class="element-name">marker</span></a></li><li><a href="masking.html#MaskElement"><span class="element-name">mask</span></a></li><li><a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a></li><li><a href="script.html#ScriptElement"><span class="element-name">script</span></a></li><li><a href="styling.html#StyleElement"><span class="element-name">style</span></a></li><li><a href="struct.html#SwitchElement"><span class="element-name">switch</span></a></li><li><a href="text.html#TextElement"><span class="element-name">text</span></a></li><li><a href="linking.html#ViewElement"><span class="element-name">view</span></a></li></ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermConditionalProcessingAttribute">条件付き処理属性</a></li>
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGDefsElement">SVGDefsElement</a></li></ul></dd></dl></div>

<p class="T">
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素は
<a href="struct.html#Head">被参照要素</a>
のためのコンテナ要素である。
可読性と
<a href="access.html">アクセシビリティ</a>
の要求から、参照される可能性のある要素は可能ならこの要素内に定義することが推奨される。
<span lang="en">
The ‘defs’ element is a container element for referenced elements. For understandability and accessibility reasons, it is recommended that, whenever possible, referenced elements be defined inside of a ‘defs’.
</span></p>

<p class="T">
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素の内容モデルは
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素と同じである。
したがって
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素の子になれるすべての要素は
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素の子になれ、逆もまた成立する。
<span lang="en">
The content model for ‘defs’ is the same as for the ‘g’ element; thus, any element that can be a child of a ‘g’ can also be a child of a ‘defs’, and vice versa.
</span></p>

<p class="T">
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素の子孫の要素は直接描画されることはない。
これらはあたかも
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素が
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素だったとしたときに，
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
プロパティが
<span class="prop-value">none</span>
に指定されていたかのように、描画木の一部分とみなされない。
しかしながら、
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素の子孫は元々の木にいつでも存在しており，他の要素からの参照は常に可能である。
したがって、
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
プロパティが
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素またはその子孫のどこかにあったとしても、他の要素からの参照を妨げることはない。
<span lang="en">
Elements that are descendants of a ‘defs’ are not rendered directly; they are prevented from becoming part of the rendering tree just as if the ‘defs’ element were a ‘g’ element and the ‘display’ property were set to none. Note, however, that the descendants of a ‘defs’ are always present in the source tree and thus can always be referenced by other elements; thus, the value of the ‘display’ property on the ‘defs’ element or any of its descendants does not prevent those elements from being referenced by other elements.
</span></p>

<p class="T">
ストリーミング環境において UA の効率的な実行を促すためには、 SVG 内容作成者は参照元の要素の先祖要素の直接の子として
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素を置き，その中に局所 IRI 参照から参照される子要素すべてを置くことが奨励される。
例えば：
<span lang="en">
To provide some SVG user agents with an opportunity to implement efficient implementations in streaming environments, creators of SVG content are encouraged to place all elements which are targets of local IRI references within a ‘defs’ element which is a direct child of one of the ancestors of the referencing element. For example:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="8cm" height="3cm"
     xmlns="http://www.w3.org/2000/svg" version="1.1"&gt;
  &lt;desc&gt;<span title="Local URI references within ancestor's 'defs' element."
    >先祖要素の 'defs' 子要素内における局所 URI 参照。</span>&lt;/desc&gt;
  &lt;defs&gt;
    &lt;linearGradient id="Gradient01"&gt;
      &lt;stop offset="20%" stop-color="#39F" /&gt;
      &lt;stop offset="90%" stop-color="#F3F" /&gt;
    &lt;/linearGradient&gt;
  &lt;/defs&gt;
  &lt;rect x="1cm" y="1cm" width="6cm" height="1cm" 
        fill="url(#Gradient01)"  /&gt;

  &lt;!-- <span title="Show outline of canvas using 'rect' element">'rect' 要素でキャンバスの境界を表示</span> --&gt;
  &lt;rect x=".01cm" y=".01cm" width="7.98cm" height="2.98cm"
        fill="none" stroke="blue" stroke-width=".02cm" /&gt;

&lt;/svg&gt;</pre>
<p class="view-as-svg"><a href="images/struct/defs01.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
上の文書では
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素が線型グラデーションを含む
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素を直接の子として持ちつつ，線型グラデーションを参照する
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素の先祖に位置している。
このように、上の文書は上述の指針に沿っている。
<span lang="en">
In the document above, the linear gradient is defined within a ‘defs’ element which is the direct child of the ‘svg’ element, which in turn is an ancestor of the ‘rect’ element which references the linear gradient. Thus, the above document conforms to the guideline.
</span></p>


<h2 title="5.4 The ‘desc’ and ‘title’ elements" id="DescriptionAndTitleElements">5.4 <span class="element-name">desc</span> 要素と <span class="element-name">title</span> 要素</h2>

<div id="DescElement">
<div class="element-summary"><div class="element-summary-name"><span class="element-name">desc</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermDescriptiveElement">記述的要素</a></dd>
<dt>内容モデル：</dt>
<dd title="Any elements or character data.">
任意の要素または文字データ
</dd>
<dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGDescElement">SVGDescElement</a></li></ul></dd></dl></div>
</div>

<div id="TitleElement">
<div class="element-summary"><div class="element-summary-name"><span class="element-name">title</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermDescriptiveElement">記述的要素</a></dd>
<dt>内容モデル：</dt>
<dd title="Any elements or character data.">
任意の要素または文字データ
</dd>
<dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGTitleElement">SVGTitleElement</a></li></ul></dd></dl></div>
</div>

<p class="T">
それぞれの
<a href="intro.html#TermContainerElement"><span class="svg-term">コンテナ要素</span></a>
や
<a href="intro.html#TermGraphicsElement"><span class="svg-term">グラフィックス要素</span></a>
には，個別に、
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
要素, またはテキストのみの説明を与える
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素，あるいはそれらの両方を指定することができる。
SVG 文書片が視覚メディアに SVG として描画される場合、
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
と
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素は，グラフィックの一部としては出力されない。
しかしながら
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素は、例えばポインティング装置で触れると現れるツールチップとして表示させることも， UA には可能である。
視覚, 聴覚の両方について代替表現は可能であり、
<a href="paths.html#PathElement"><span class="element-name">path</span></a>
などのグラフィックス要素を表示する代わりに
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
や
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素を表現することは十分あり得る。
このようなことは、（場合によっては利用者の）スタイルシートに対する変更を通して，容易に実現できる。
階層構造が深い場合や,
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の参照を辿るような場合、どこまで深く説明文を掘り下げるかの制御を 利用者に委ねた方が望ましい場面は多々ある。
<span lang="en">
Each container element or graphics element in an SVG drawing can supply a ‘desc’ and/or a ‘title’ description string where the description is text-only. When the current SVG document fragment is rendered as SVG on visual media, ‘desc’ and ‘title’ elements are not rendered as part of the graphics. User agents may, however, for example, display the ‘title’ element as a tooltip, as the pointing device moves over particular elements. Alternate presentations are possible, both visual and aural, which display the ‘desc’ and ‘title’ elements but do not display ‘path’ elements or other graphics elements. This is readily achieved by using a different (perhaps user) style sheet. For deep hierarchies, and for following ‘use’ element references, it is sometimes desirable to allow the user to control how deep they drill down into descriptive text.
</span></p>

<p class="T">
適合 SVG 文書片においては、どの
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素もその親の最初の子要素になるべきである。
注記：ツールチップの表示に
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
を実際に利用する実装には、
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
が実際に最初の子要素になっているときに限り，そうするものが多い。
<span lang="en">
In conforming SVG document fragments, any ‘title’ element should be the first child element of its parent. Note that those implementations that do use ‘title’ to display a tooltip often will only do so if the ‘title’ is indeed the first child element of its parent.
</span></p>

<p class="T">
以下に例を挙げる。
通常の処理では UA は
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素内の
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
と
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素を除いた残りの部分のみを表示する。
<span lang="en">
The following is an example. In typical operation, the SVG user agent would not render the ‘desc’ and ‘title’ elements but would render the remaining contents of the ‘g’ element.
</span></p>


<pre>&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg SYSTEM "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg xmlns="http://www.w3.org/2000/svg"
     version="1.1" width="4in" height="3in"&gt;
  &lt;g&gt;
    &lt;title&gt;<span title="Company sales by region">地域別売上高</span>&lt;/title&gt;
    &lt;desc&gt;
	  <span title="This is a bar chart which shows  company sales by region."
	  >これは地域別売上高を表す棒グラフである。</span>
    &lt;/desc&gt;
    &lt;!-- <span title="Bar chart defined as vector data">ベクターデータで定義される棒グラフ</span> --&gt;
  &lt;/g&gt;
&lt;/svg&gt;
</pre>

<p class="T">
説明要素とタイトル要素には他の名前空間でマークアップされたテキストも含められる：
<span lang="en">
Description and title elements can contain marked-up text from other namespaces. Here is an example:
</span></p>


<pre>&lt;?xml version="1.0" standalone="yes"?&gt;
&lt;svg xmlns="http://www.w3.org/2000/svg"
     version="1.1" width="4in" height="3in"&gt;
  &lt;desc xmlns:mydoc="http://example.org/mydoc"&gt;
    &lt;mydoc:title&gt;<span title="This is an example SVG file"
	>これは例示用 SVG ファイル</span>&lt;/mydoc:title&gt;
    &lt;mydoc:para&gt;<span title="The global description uses markup from the 
      &lt;mydoc:emph&gt;mydoc&lt;/mydoc:emph&gt; namespace."
	  >全体的な説明には &lt;mydoc:emph&gt;mydoc&lt;/mydoc:emph&gt;
      名前空間によるマークアップを利用。</span>&lt;/mydoc:para&gt;
  &lt;/desc&gt;
  &lt;g&gt;
    &lt;!-- <span title="the picture goes here">絵図はここに</span> --&gt;
  &lt;/g&gt;
&lt;/svg&gt;
</pre>

<p class="T">
文書作成者は、独立した SVG 文書の
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に対し常に，
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素を子要素として与えるべきである。
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の子要素としての
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素は SVG 文書片の内容確認に役立つ。
利用者はしばしば文脈の外から文書を参照するので、文書作成者は文脈が豊かなタイトルを提供するべきである。
「序文」の様な文脈情報に乏しいタイトルより、「中世の養蜂業・序文」の様なタイトルを付けるべきである。
UA は
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に
<span class="element-name">title</span>
子要素があれば、アクセシビリティに配慮して必ず利用者に示されるようにすべきである。
このような仕組の実装は UA 側に託されている（例えば、音声によるキャプション）。
<span lang="en">
Authors should always provide a ‘title’ child element to the outermost svg element within a stand-alone SVG document. The ‘title’ child element to an ‘svg’ element serves the purposes of identifying the content of the given SVG document fragment. Since users often consult documents out of context, authors should provide context-rich titles. Thus, instead of a title such as "Introduction", which doesn't provide much contextual background, authors should supply a title such as "Introduction to Medieval Bee-Keeping" instead. For reasons of accessibility, user agents should always make the content of the ‘title’ child element to the outermost svg element available to users. The mechanism for doing so depends on the user agent (e.g., as a caption, spoken).
</span></p>

<p class="T">
多くの SVG の要素（特にコンテナ要素とテキスト要素）の DTD 定義では
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>,
および
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
子要素の配置や数に制限を設けていない。
この融通性は、コンテナ要素に対する一貫性を備えた内容モデルが開発されるまでの，一時的な措置である。
一部のコンテナ要素は 混成内容を許容し、望まれる制約を
<a href="http://www.w3.org/TR/2008/REC-xml-20081126/#sec-mixed-content">XML の混成内容の規則</a>
([<a href="refs.html#ref-XML10">XML10</a>], 3.2.2 節)
が受け入れてくれないからである。
将来版の SVG 言語の表現は、 DTD よりも表出的になり，より制約された混成内容規則を持てるようになるであろう。
すべての要素に対し、高々 1 個の
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
と高々 1 個の
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
を子要素として与え，それらを（
<a href="metadata.html#MetadataElement"><span class="element-name">metadata</span></a>
要素と文字データを除く）他のすべての子要素より先に位置させることが強く推奨される。
UA は、処理の際に複数の
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
や
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
からの選択を迫られた際には，最初のものを選ぶべきである（例えばツールチップにどのテキストを用いるかなど）。
<span lang="en">
The DTD definitions of many of SVG's elements (particularly, container and text elements) place no restriction on the placement or number of the ‘desc’ and ‘title’ sub-elements. This flexibility is only present so that there will be a consistent content model for container elements, because some container elements in SVG allow for mixed content, and because the mixed content rules for XML ([XML10], section 3.2.2) do not permit the desired restrictions. Representations of future versions of the SVG language might use more expressive representations than DTDs which allow for more restrictive mixed content rules. It is strongly recommended that at most one ‘desc’ and at most one ‘title’ element appear as a child of any particular element, and that these elements appear before any other child elements (except possibly ‘metadata’ elements) or character data content. If user agents need to choose among multiple ‘desc’ or ‘title’ elements for processing (e.g., to decide which string to use for a tooltip), the user agent shall choose the first one.
</span></p>


<h2 title="5.5 The ‘symbol’ element" id="SymbolElement">5.5 <span class="element-name">symbol</span> 要素</h2>

<div class="element-summary"><div class="element-summary-name"><span class="element-name">symbol</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermContainerElement">コンテナ要素</a>,
<a href="intro.html#TermStructuralElement">構造要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
<li><a class="T-ex" href="intro.html#TermShapeElement">図形要素</a></li>
<li><a class="T-ex" href="intro.html#TermStructuralElement">構造要素</a></li>
<li><a class="T-ex" href="intro.html#TermGradientElement">グラデーション要素</a></li>
<li><a href="linking.html#AElement"><span class="element-name">a</span></a></li><li><a href="text.html#AltGlyphDefElement"><span class="element-name">altGlyphDef</span></a></li><li><a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a></li><li><a href="color.html#ColorProfileElement"><span class="element-name">color-profile</span></a></li><li><a href="interact.html#CursorElement"><span class="element-name">cursor</span></a></li><li><a href="filters.html#FilterElement"><span class="element-name">filter</span></a></li><li><a href="fonts.html#FontElement"><span class="element-name">font</span></a></li><li><a href="fonts.html#FontFaceElement"><span class="element-name">font-face</span></a></li><li><a href="extend.html#ForeignObjectElement"><span class="element-name">foreignObject</span></a></li><li><a href="struct.html#ImageElement"><span class="element-name">image</span></a></li><li><a href="painting.html#MarkerElement"><span class="element-name">marker</span></a></li><li><a href="masking.html#MaskElement"><span class="element-name">mask</span></a></li><li><a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a></li><li><a href="script.html#ScriptElement"><span class="element-name">script</span></a></li><li><a href="styling.html#StyleElement"><span class="element-name">style</span></a></li><li><a href="struct.html#SwitchElement"><span class="element-name">switch</span></a></li><li><a href="text.html#TextElement"><span class="element-name">text</span></a></li><li><a href="linking.html#ViewElement"><span class="element-name">view</span></a></li></ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a></li><li><a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGSymbolElement">SVGSymbolElement</a></li></ul></dd></dl></div>

<p class="T">
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素は、グラフィックのひな型オブジェクトを定義し，
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素によりインスタンス化される。
<span lang="en">
The ‘symbol’ element is used to define graphical template objects which can be instantiated by a ‘use’ element.
</span></p>

<p class="T">
グラフィックに繰り返し用いる
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素の利用により、文書に構造と意味論が加えられる。
多彩な構造を備える文書は、グラフィック, 読み上げ, あるいは点字による出力が可能になり、
<a href="access.html">アクセシビリティ</a>
も向上する。
<span lang="en">
The use of ‘symbol’ elements for graphics that are used multiple times in the same document adds structure and semantics. Documents that are rich in structure may be rendered graphically, as speech, or as braille, and thus promote accessibility.
</span></p>

<p class="T">
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
と
<a href="struct.html#GElement"><span class="element-name">g</span></a>
の根本的な相違は：
<span lang="en">
The key distinctions between a ‘symbol’ and a ‘g’ are:
</span></p>


<ul>

<li class="T">
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素は それ自身としては描画されない。
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素により生成される
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素のインスタンスのみが描画される。
<span lang="en">
A ‘symbol’ element itself is not rendered. Only instances of a ‘symbol’ element (i.e., a reference to a ‘symbol’ by a ‘use’ element) are rendered.
</span></li>

<li class="T">
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素は、それを参照する
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素で定義されるビューポート矩形に 適宜 拡縮させてはめ込むための，
<a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a>
属性と
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性を持つ。
<span lang="en">
A ‘symbol’ element has attributes ‘viewBox’ and ‘preserveAspectRatio’ which allow a ‘symbol’ to scale-to-fit within a rectangular viewport defined by the referencing ‘use’ element.
</span></li>
</ul>

<p class="T">
<a href="painting.html#MarkerElement"><span class="element-name">marker</span></a>
要素と
<a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a>
要素は
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素と密接に関連する。
<span lang="en">
Closely related to the ‘symbol’ element are the ‘marker’ and ‘pattern’ elements.
</span></p>

<p class="T">
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素は決して直接描画されることはなく、
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素からの参照以外の用途はない。
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
プロパティは
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素には適用されない。
すなわち，
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素は、
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
プロパティが <span class="prop-value">none</span> 以外の値に設定されていても 直接描画されることはなく，
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素自身あるいはその先祖において
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
プロパティが <span class="prop-value">none</span> に設定されていても 参照を通して利用できる。
<span lang="en">
‘symbol’ elements are never rendered directly; their only usage is as something that can be referenced using the ‘use’ element. The ‘display’ property does not apply to the ‘symbol’ element; thus, ‘symbol’ elements are not directly rendered even if the ‘display’ property is set to a value other than none, and ‘symbol’ elements are available for referencing even when the ‘display’ property on the ‘symbol’ element or any of its ancestors is set to none.
</span></p>


<h2 title="5.6 The ‘use’ element" id="UseElement">5.6 <span class="element-name">use</span> 要素</h2>


<div class="element-summary"><div class="element-summary-name"><span class="element-name">use</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermGraphicsElement">グラフィックス要素</a>,
<a href="intro.html#TermGraphicsReferencingElement">グラフィックス参照要素</a>,
<a href="intro.html#TermStructuralElement">構造要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
</ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermConditionalProcessingAttribute">条件付き処理属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a class="T-ex" href="intro.html#TermXLinkAttributes">xlink 属性</a><span>
<a href="struct.html#UseElementHrefAttribute"><span class="attr-name">xlink:href</span></a></span></li><li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a></li><li><a href="struct.html#UseElementXAttribute"><span class="attr-name">x</span></a></li><li><a href="struct.html#UseElementYAttribute"><span class="attr-name">y</span></a></li><li><a href="struct.html#UseElementWidthAttribute"><span class="attr-name">width</span></a></li><li><a href="struct.html#UseElementHeightAttribute"><span class="attr-name">height</span></a></li><li><a href="struct.html#UseElementHrefAttribute"><span class="attr-name">xlink:href</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGUseElement">SVGUseElement</a></li></ul></dd></dl></div>

<p class="T">
どの
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>,
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>,
<a href="struct.html#GElement"><span class="element-name">g</span></a>,
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素あるいは
<a href="intro.html#TermGraphicsElement"><span class="svg-term">グラフィックス要素</span></a>
も、
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素によるひな型としての再利用（すなわちインスタンス化）の対象になる。
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素は、文書の与えられた場所において他の要素を参照し，そのグラフィック内容の取り込みと描画を指示する。
<span lang="en">
Any ‘svg’, ‘symbol’, ‘g’, graphics element or other ‘use’ is potentially a template object that can be re-used (i.e., "instanced") in the SVG document via a ‘use’ element. The ‘use’ element references another element and indicates that the graphical contents of that element is included/drawn at that given point in the document.
</span></p>

<p class="T">
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素とは異なり、
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素は，文書全体を参照することはできない。
<span lang="en">
Unlike ‘image’, the ‘use’ element cannot reference entire files.
</span></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素は省略可能な次の属性：
<a href="struct.html#UseElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#UseElementYAttribute"><span class="attr-name">y</span></a>,
<a href="struct.html#UseElementWidthAttribute"><span class="attr-name">width</span></a>,
<a href="struct.html#UseElementHeightAttribute"><span class="attr-name">height</span></a>
を持つ。
これらは、参照先の要素のグラフィック内容を現在の座標系の矩形領域に写像するために利用される。
<span lang="en">
The ‘use’ element has optional attributes ‘x’, ‘y’, ‘width’ and ‘height’ which are used to map the graphical contents of the referenced element onto a rectangular region within the current coordinate system.
</span></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素による効果は、あたかも参照先の要素の内容が DOM 木において — その
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素を親とする別個の非公開木として，かつ
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素のすべての先祖がその木の先祖になるように — 末端まで複製されたかのようにふるまう。
複製された DOM 木は非公開なので、 SVG 文書オブジェクトモデル（ DOM ）においては
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素とその属性が存在するだけであり，参照先の要素の内容が
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の子としては現れることはない。
<span lang="en">
The effect of a ‘use’ element is as if the contents of the referenced element were deeply cloned into a separate non-exposed DOM tree which had the ‘use’ element as its parent and all of the ‘use’ element's ancestors as its higher-level ancestors. Because the cloned DOM tree is non-exposed, the SVG Document Object Model (DOM) only contains the ‘use’ element and its attributes. The SVG DOM does not show the referenced element's contents as children of ‘use’ element.
</span></p>

<p class="T">
<a href="styling.html#StylingWithCSS">CSS によるスタイル付け</a>
をサポートする UA においては、この概念的な非公開 DOM 木の中への，参照先の要素とその子孫の末端までの複製は、
<a href="http://www.w3.org/TR/2008/REC-CSS2-20080411/cascade.html">CSS カスケード</a>
([<a href="refs.html#ref-CSS2">CSS2</a>], 6 節)
によりもたらされる参照先の要素とその内容のすべてのプロパティ値 の複製も意味する。
CSS2 セレクタの適用については、元の（すなわち参照先の）要素については 正規の文書構造の一部なので適用される一方，（概念的な）複製木については 正規の文書構造の一部ではないので適用されない。
<span lang="en">
For user agents that support Styling with CSS, the conceptual deep cloning of the referenced element into a non-exposed DOM tree also copies any property values resulting from the CSS cascade ([CSS2], chapter 6) on the referenced element and its contents. CSS2 selectors can be applied to the original (i.e., referenced) elements because they are part of the formal document structure. CSS2 selectors cannot be applied to the (conceptually) cloned DOM tree because its contents are not part of the formal document structure.
</span></p>

<p class="T">
しかしながら、プロパティ継承においては、参照先の要素がテキストそのままとして
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素下に末端の子孫まで複製されているものとみなされ，
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素とその先祖要素のプロパティを継承し，複製木内のインスタンス化された要素は 参照先の要素の元々の親のプロパティを継承しない。
<span lang="en">
Property inheritance, however, works as if the referenced element had been textually included as a deeply cloned child of the ‘use’ element. The referenced element inherits properties from the ‘use’ element and the ‘use’ element's ancestors. An instance of a referenced element does not inherit properties from the referenced element's original parents.
</span></p>

<p class="T">
もしイベント属性が参照先の要素にあてがわれている場合、そのイベントの実際の標的は「インスタンス化された木」内の対応する
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトになる。
<span lang="en">
If event attributes are assigned to referenced elements, then the actual target for the event will be the SVGElementInstance object within the "instance tree" corresponding to the given referenced element.
</span></p>

<p class="T">
非公開木におけるイベント処理は、
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトへ配送されることを除けば，あたかも参照先の要素がテキストのまま
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素下に末端の子孫まで複製されたかのように処理される。
イベントの target 属性と currentTarget 属性は、参照先の部分木の中のイベントの標的に対応する
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
と現在の標的要素に設定される。
イベントは通常の木のごとく、木の非公開部分も公開部分も辿って伝播する：最初はルート要素から
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素へ，次に非公開部分をイベントの標的まで辿り（捕獲過程 — capture phase ），標的でバブル化し、再び非公開部分を
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素まで辿った後，通常の木を辿ってルート要素まで浮上する（浮上過程 — bubbling phase ）。
<span lang="en">
The event handling for the non-exposed tree works as if the referenced element had been textually included as a deeply cloned child of the ‘use’ element, except that events are dispatched to the SVGElementInstance objects. The event's target and currentTarget attributes are set to the SVGElementInstance that corresponds to the target and current target elements in the referenced subtree. An event propagates through the exposed and non-exposed portions of the tree in the same manner as it would in the regular document tree: first going from the root element to the ‘use’ element and then through non-exposed tree elements in the capture phase, followed by the target phase at the target of the event, then bubbling back through non-exposed tree to the use element and then back through regular tree to the root element in bubbling phase.
</span></p>

<p class="T">
同じ要素に対応するすべての
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトは、イベントリスナのリストを共有する。
どのオブジェクトがイベントリスナを呼び出したかは、イベントの currentTarget 属性から知ることができる。
<span lang="en">
An element and all its corresponding SVGElementInstance objects share an event listener list. The currentTarget attribute of the event can be used to determine through which object an event listener was invoked.
</span></p>

<p class="T">
<a href="painting.html#VisibilityProperty"><span class="prop-name">visibility</span></a>
プロパティの振るまいは、ここでのプロパティ継承モデルに従う。
したがって、
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素で
<span class="prop-value">visibility:hidden</span>
と指定されていたとしても，参照先の内容が描画されなくなるわけではない。
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素で
<span class="prop-value">visibility:hidden</span>
と指定されていて, 参照先の要素では
<span class="prop-value">visibility:hidden</span>
または
<span class="prop-value">visibility:inherit</span>
と指定されているならば、その要素は見えなくなる。
しかしながら，参照先の要素で
<span class="prop-value">visibility:visible</span>
が指定されていた場合、たとえ
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素で
<span class="prop-value">visibility:hidden</span>
と指定されていたとしても，その要素は見えることになる。
<span lang="en">
The behavior of the ‘visibility’ property conforms to this model of property inheritance. Thus, specifying 'visibility:hidden' on a ‘use’ element does not guarantee that the referenced content will not be rendered. If the ‘use’ element specifies 'visibility:hidden' and the element it references specifies 'visibility:hidden' or 'visibility:inherit', then that one element will be hidden. However, if the referenced element instead specifies 'visibility:visible', then that element will be visible even if the ‘use’ element specifies 'visibility:hidden'.
</span></p>

<p class="T">
参照先の要素におけるアニメーションは、そのインスタンスにおいても有効である。
<span lang="en">
Animations on a referenced element will cause the instances to also be animated.
</span></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素における視覚上の効果は、あたかも
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が，以下のようにして生成される内容に置き換えられたかのようにふるまう：
<span lang="en">
A ‘use’ element has the same visual effect as if the ‘use’ element were replaced by the following generated content:
</span></p>


<ol>
	<li class="T">
生成される内容においては、
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
は
<a href="struct.html#GElement"><span class="element-name">g</span></a>
によって置き換えられ，置き換えた
<a href="struct.html#GElement"><span class="element-name">g</span></a>
に
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#UseElementYAttribute"><span class="attr-name">y</span></a>,
<a href="struct.html#UseElementWidthAttribute"><span class="attr-name">width</span></a>,
<a href="struct.html#UseElementHeightAttribute"><span class="attr-name">height</span></a>,
<a href="struct.html#UseElementHrefAttribute"><span class="attr-name">xlink:href</span></a>
属性を除いたすべての属性が移植される。
<span class="attr-value">x</span>,
<span class="attr-value">y</span>
を
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#UseElementYAttribute"><span class="attr-name">y</span></a>
属性の値とするとき、変換
<span class="attr-value">translate(x, y)</span>
が
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素の
<a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a>
属性の終端（つまり，右側）に付加される。
<span lang="en">
<span lang="ja">（下の各項の原文における共通部分）</span>
</span></li>

	<li class="T">
次に：
		<dl>
			<dt class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素を参照している場合
</dt>
			<dd class="T">
参照先の
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
とその内容は、根元の
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
が
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
に置き換えられることを除いて，生成される木に末端まで複製される。

この生成された
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
は常に明示的に
<a href="struct.html#SVGElementWidthAttribute"><span class="attr-name">width</span></a>
属性と
<a href="struct.html#SVGElementHeightAttribute"><span class="attr-name">height</span></a>
属性の値を持ち，
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementWidthAttribute"><span class="attr-name">width</span></a>
と
<a href="struct.html#UseElementHeightAttribute"><span class="attr-name">height</span></a>
の値が移植されるが、これらが
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に与えられていないものについては値 <span class="attr-value">'100%'</span> をとる。
<span lang="en">
If the ‘use’ element references a ‘symbol’ element: In the generated content, the ‘use’ will be replaced by ‘g’, where all attributes from the ‘use’ element except for ‘x’, ‘y’, ‘width’, ‘height’ and ‘xlink:href’ are transferred to the generated ‘g’ element. An additional transformation translate(x,y) is appended to the end (i.e., right-side) of the ‘transform’ attribute on the generated ‘g’, where x and y represent the values of the ‘x’ and ‘y’ attributes on the ‘use’ element. The referenced ‘symbol’ and its contents are deep-cloned into the generated tree, with the exception that the ‘symbol’ is replaced by an ‘svg’. This generated ‘svg’ will always have explicit values for attributes ‘width’ and ‘height’. If attributes ‘width’ and/or ‘height’ are provided on the ‘use’ element, then these attributes will be transferred to the generated ‘svg’. If attributes ‘width’ and/or ‘height’ are not specified, the generated ‘svg’ element will use values of '100%' for these attributes.
</span></dd>

			<dt class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素を参照している場合
</dt>
			<dd class="T">
参照先の
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
とその内容は生成される木に末端まで複製される。
もし
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に
<a href="struct.html#UseElementWidthAttribute"><span class="attr-name">width</span></a>
や
<a href="struct.html#UseElementHeightAttribute"><span class="attr-name">height</span></a>
属性が与えられていた場合、これらは
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の対応する値を上書きする。
<span lang="en">
If the ‘use’ element references an ‘svg’ element: In the generated content, the ‘use’ will be replaced by ‘g’, where all attributes from the ‘use’ element except for ‘x’, ‘y’, ‘width’, ‘height’ and ‘xlink:href’ are transferred to the generated ‘g’ element. An additional transformation translate(x,y) is appended to the end (i.e., right-side) of the ‘transform’ attribute on the generated ‘g’, where x and y represent the values of the ‘x’ and ‘y’ attributes on the ‘use’ element. The referenced ‘svg’ and its contents are deep-cloned into the generated tree. If attributes ‘width’ and/or ‘height’ are provided on the ‘use’ element, then these values will override the corresponding attributes on the ‘svg’ in the generated tree.
</span></dd>

			<dt class="T">他の場合</dt>
			<dd class="T">
参照先のオブジェクトとその内容は生成される木に末端まで複製される。
<span lang="en">
Otherwise: In the generated content, the ‘use’ will be replaced by ‘g’, where all attributes from the ‘use’ element except for ‘x’, ‘y’, ‘width’, ‘height’ and ‘xlink:href’ are transferred to the generated ‘g’ element. An additional transformation translate(x,y) is appended to the end (i.e., right-side) of the ‘transform’ attribute on the generated ‘g’, where x and y represent the values of the ‘x’ and ‘y’ attributes on the ‘use’ element. The referenced object and its contents are deep-cloned into the generated tree.
</span></dd>

		</dl>
	</li>
</ol>

<p class="T">
<a href="styling.html#StylingWithCSS">CSS によるスタイル付け</a>
をサポートする UA においては、生成された
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素は
<a href="http://www.w3.org/TR/2008/REC-CSS2-20080411/cascade.html">CSS カスケード</a>
([<a href="refs.html#ref-CSS2">CSS2</a>], 6 節)
により「カスケードされた」
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素のプロパティ値を一緒に運ぶ。
加えて、参照先のリソースの（末端までの）複製は、元の（つまり、参照先の）要素の「カスケードされた」プロパティ値も一緒に運ぶ。
したがって，
<a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a>
属性, および
<a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a>
属性と組み合わせて用いられる様々な CSS セレクタによる効果は、実質的には，生成された内容において「カスケードされた」プロパティ値を伝達する機能上等価な
<a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a>
属性への置き換えになる。
<span lang="en">
For user agents that support Styling with CSS, the generated ‘g’ element carries along with it the "cascaded" property values on the ‘use’ element which result from the CSS cascade ([CSS2], chapter 6). Additionally, the copy (deep clone) of the referenced resource carries along with it the "cascaded" property values resulting from the CSS cascade on the original (i.e., referenced) elements. Thus, the result of various CSS selectors in combination with the ‘class’ and ‘style’ attributes are, in effect, replaced by the functional equivalent of a ‘style’ attribute in the generated content which conveys the "cascaded" property values.
</span></p>

<p class="T">
下の <span class="example-ref">Example Use01</span> に
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
を利用する単純な
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素を示す：
<span lang="en">
Example Use01 below has a simple ‘use’ on a ‘rect’.
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="10cm" height="3cm" viewBox="0 0 100 30" version="1.1"
     xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  &lt;desc&gt;Example Use01 - <span title="Simple case of 'use' on a 'rect'">'rect' を利用する単純な 'use'</span>&lt;/desc&gt;
  &lt;defs&gt;
    &lt;rect id="MyRect" width="60" height="10"/&gt;
  &lt;/defs&gt;
  &lt;rect x=".1" y=".1" width="99.8" height="29.8"
        fill="none" stroke="blue" stroke-width=".2" /&gt;
  &lt;use x="20" y="10" xlink:href="#MyRect" /&gt;
&lt;/svg&gt;</pre><table><caption>Example Use01</caption><tbody><tr><td><img title="Example Use01 — Simple case of 'use' on a 'rect'" alt="Example Use01 — Simple case of 'use' on a 'rect'" src="images/struct/Use01.png"></td></tr></tbody></table>
<p class="view-as-svg"><a href="images/struct/Use01.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
視覚効果においては、次と同じになる：
<span lang="en">
The visual effect would be equivalent to the following document:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="10cm" height="3cm" viewBox="0 0 100 30"
     xmlns="http://www.w3.org/2000/svg" version="1.1"&gt;
  &lt;desc&gt;Example Use01-GeneratedContent - <span title="Simple case of 'use' on a 'rect'"
  >'rect' を利用する単純な 'use'</span>&lt;/desc&gt;
  &lt;!-- <span title="'defs' section left out">'defs' 部は省略</span> --&gt;

  &lt;rect x=".1" y=".1" width="99.8" height="29.8"
        fill="none" stroke="blue" stroke-width=".2" /&gt;

  &lt;!-- <span title="Start of generated content. Replaces 'use'">'use' を置き換える生成内容はここから</span> --&gt;
  &lt;g transform="translate(20,10)"&gt;
    &lt;rect width="60" height="10"/&gt;
  &lt;/g&gt;
  &lt;!-- <span title="End of generated content">生成内容はここまで</span> --&gt;

&lt;/svg&gt;</pre>
<p class="view-as-svg"><a href="images/struct/Use01-GeneratedContent.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
下の <span class="example-ref">Example Use02</span> に
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
を利用する
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素を示す：
<span lang="en">
Example Use02 below has a ‘use’ on a ‘symbol’.
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="10cm" height="3cm" viewBox="0 0 100 30" version="1.1"
     xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  &lt;desc&gt;Example Use02 - <span title="'use' on a 'symbol'">'symbol' を利用する 'use'</span>&lt;/desc&gt;
  &lt;defs&gt;
    &lt;symbol id="MySymbol" viewBox="0 0 20 20"&gt;
      &lt;desc&gt;<span title="four rectangles in a grid">MySymbol — 格子状に並ぶ４矩形</span>&lt;/desc&gt;
      &lt;rect x="1" y="1" width="8" height="8"/&gt;
      &lt;rect x="11" y="1" width="8" height="8"/&gt;
      &lt;rect x="1" y="11" width="8" height="8"/&gt;
      &lt;rect x="11" y="11" width="8" height="8"/&gt;
    &lt;/symbol&gt;
  &lt;/defs&gt;
  &lt;rect x=".1" y=".1" width="99.8" height="29.8"
        fill="none" stroke="blue" stroke-width=".2" /&gt;
  &lt;use x="45" y="10" width="10" height="10" 
       xlink:href="#MySymbol" /&gt;
&lt;/svg&gt;</pre><table><caption>Example Use02</caption><tbody><tr><td><img title="Example Use02 — 'use' on a 'symbol'" alt="Example Use02 — 'use' on a 'symbol'" src="images/struct/Use02.png"></td></tr></tbody></table>
<p class="view-as-svg"><a href="images/struct/Use02.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
視覚効果においては、次と同じになる：
<span lang="en">
The visual effect would be equivalent to the following document:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="10cm" height="3cm" viewBox="0 0 100 30"
     xmlns="http://www.w3.org/2000/svg" version="1.1"&gt;
  &lt;desc&gt;Example Use02-GeneratedContent - <span title="'use' on a 'symbol'"
  >'symbol' を利用する 'use'</span>&lt;/desc&gt;

  &lt;!-- <span title="'defs' section left out">'defs' 部は省略</span> --&gt;

  &lt;rect x=".1" y=".1" width="99.8" height="29.8"
        fill="none" stroke="blue" stroke-width=".2" /&gt;

  &lt;!-- <span title="Start of generated content. Replaces 'use'"
  >'use' を置き換える生成内容はここから</span> --&gt;
  &lt;g transform="translate(45, 10)" &gt;
    &lt;!-- <span title="Start of referenced 'symbol'. 'symbol' replaced by 'svg',
         with x,y,width,height=0,0,100%,100%"
		 >参照先の 'symbol' 開始。'symbol' は
         x,y,width,height=0,0,100%,100% に設定された 'svg' に置き換わる</span> --&gt;
    &lt;svg width="10" height="10" 
         viewBox="0 0 20 20"&gt;
      &lt;rect x="1" y="1" width="8" height="8"/&gt;
      &lt;rect x="11" y="1" width="8" height="8"/&gt;
      &lt;rect x="1" y="11" width="8" height="8"/&gt;
      &lt;rect x="11" y="11" width="8" height="8"/&gt;
    &lt;/svg&gt;
    &lt;!-- <span title="End of referenced symbol">ここまでが参照先の 'symbol'</span> --&gt;
  &lt;/g&gt;
  &lt;!-- <span title="End of generated content">生成内容はここまで</span> --&gt;

&lt;/svg&gt;</pre>
<p class="view-as-svg"><a href="images/struct/Use02-GeneratedContent.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
<span class="example-ref">Example Use03</span> に
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a>
属性を持つときどのような効果が生じるかを示す：
<span lang="en">
Example Use03 illustrates what happens when a ‘use’ has a ‘transform’ attribute.
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="10cm" height="3cm" viewBox="0 0 100 30" version="1.1"
     xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  &lt;desc&gt;Example Use03 - <span title="'use' with a 'transform' attribute"
  >'transform' 属性を伴う 'use'</span> &lt;/desc&gt;
  &lt;defs&gt;
    &lt;rect id="MyRect" x="0" y="0" width="60" height="10"/&gt;
  &lt;/defs&gt;
  &lt;rect x=".1" y=".1" width="99.8" height="29.8"
        fill="none" stroke="blue" stroke-width=".2" /&gt;
  &lt;use xlink:href="#MyRect"
       transform="translate(20,2.5) rotate(10)" /&gt;
&lt;/svg&gt;</pre><table><caption>Example Use03</caption><tbody><tr><td><img title="Example Use03 — 'use' with a 'transform' attribute" alt="Example Use03 — 'use' with a 'transform' attribute" src="images/struct/Use03.png"></td></tr></tbody></table>
<p class="view-as-svg"><a href="images/struct/Use03.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
視覚効果においては、次と同じになる：
<span lang="en">
The visual effect would be equivalent to the following document:
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="10cm" height="3cm" viewBox="0 0 100 30"
     xmlns="http://www.w3.org/2000/svg" version="1.1"&gt;
  &lt;desc&gt;Example Use03-GeneratedContent - <span title="'use' with a 'transform' attribute"
  >'transform' 属性を伴う 'use'</span>&lt;/desc&gt;

  &lt;!-- <span title="'defs' section left out">'defs' 部は省略</span> --&gt;

  &lt;rect x=".1" y=".1" width="99.8" height="29.8"
        fill="none" stroke="blue" stroke-width=".2" /&gt;

  &lt;!-- <span title="Start of generated content. Replaces 'use'"
  >'use' を置き換える生成内容はここから</span> --&gt;
  &lt;g transform="translate(20,2.5) rotate(10)"&gt;
    &lt;rect x="0" y="0" width="60" height="10"/&gt;
  &lt;/g&gt;
  &lt;!-- <span title="End of generated content">生成内容はここまで</span> --&gt;

&lt;/svg&gt;</pre>
<p class="view-as-svg"><a href="images/struct/Use03-GeneratedContent.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
<span class="example-ref">Example Use04</span>
に
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に対する種々の CSS によるスタイル付けの適用を示す：
<span lang="en">
Example Use04 illustrates a ‘use’ element with various methods of applying CSS styling.
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="12cm" height="3cm" viewBox="0 0 1200 300" version="1.1"
     xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  &lt;desc&gt;Example Use04 - <span title="'use' with CSS styling"
  >'use' に対する CSS によるスタイル付け</span>&lt;/desc&gt;
  &lt;defs style=" /* 規則 9 */ stroke-miterlimit: 10" &gt;
    &lt;path id="MyPath" d="M300 50 L900 50 L900 250 L300 250"
                     class="MyPathClass"
                     style=" /* 規則 10 */ stroke-dasharray:300,100" /&gt;
  &lt;/defs&gt;
  &lt;style type="text/css"&gt;
    &lt;![CDATA[
      /* 規則<!-- rule --> 1 */ #MyUse { fill: blue }
      /* 規則 2 */ #MyPath { stroke: red }
      /* 規則 3 */ use { fill-opacity: .5 }
      /* 規則 4 */ path { stroke-opacity: .5 }
      /* 規則 5 */ .MyUseClass { stroke-linecap: round }
      /* 規則 6 */ .MyPathClass { stroke-linejoin: bevel }
      /* 規則 7 */ use &gt; path { shape-rendering: optimizeQuality }
      /* 規則 8 */ g &gt; path { visibility: hidden }
    ]]&gt;
  &lt;/style&gt;

  &lt;rect x="0" y="0" width="1200" height="300"
         style="fill:none; stroke:blue; stroke-width:3"/&gt;
  &lt;g style=" /* 規則 11 */ stroke-width:40"&gt;
    &lt;use id="MyUse" xlink:href="#MyPath" 
         class="MyUseClass"
         style="/* 規則 12 */ stroke-dashoffset:50" /&gt;
  &lt;/g&gt;
&lt;/svg&gt;</pre><table><caption>Example Use04</caption><tbody><tr><td><img title="Example Use04 — 'use' with CSS styling" alt="Example Use04 — 'use' with CSS styling" src="images/struct/Use04.png"></td></tr></tbody></table>
<p class="view-as-svg"><a href="images/struct/Use04.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
視覚効果においては下に示す文書と同じになる。
スタイル規則のうち、一部（規則 1-6, 規則 10-12 ）は生成内容に反映され，それ以外（規則 7-9 ）は反映されないことを確認されたい。
生成内容に反映されない規則とは：
<span lang="en">
The visual effect would be equivalent to the following document. Observe that some of the style rules above apply to the generated content (i.e., rules 1-6, 10-12), whereas others do not (i.e., rules 7-9). The rules which do not affect the generated content are:
</span></p>


<ul>

<li class="T">
規則 7,8 ： CSS セレクタは、生成された木ではなく，正規の文書木にしか適用されない。
したがって、これらのセレクタは無効である。
<span lang="en">
Rules 7 and 8: CSS selectors only apply to the formal document tree, not on the generated tree; thus, these selectors will not yield a match.
</span></li>

<li class="T">
規則 9 ：生成された木は
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の先祖からのみプロパティを継承し、参照先の要素の先祖からは何も継承しない。
したがってこの規則は生成内容に反映されない。
<span lang="en">
Rule 9: The generated tree only inherits from the ancestors of the ‘use’ element and does not inherit from the ancestors of the referenced element; thus, this rule does not affect the generated content.
</span></li>
</ul>

<p class="T">
例証のための便宜上、下の生成内容では有効なセレクタを
<a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a>
属性としてインライン化している。
<span lang="en">
In the generated content below, the selectors that yield a match have been transferred into inline ‘style’ attributes for illustrative purposes.
</span></p>


<pre class="xml">&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="12cm" height="3cm" viewBox="0 0 1200 300"
     xmlns="http://www.w3.org/2000/svg" version="1.1"&gt;
  &lt;desc&gt;Example Use04-GeneratedContent - <span title="'use' with a 'transform' attribute"
  >'transform' 属性を伴う 'use'</span> &lt;/desc&gt;

  &lt;!-- <span title="'style' and 'defs' sections left out">'style' 部と 'defs' 部は省略</span> --&gt;

  &lt;rect x="0" y="0" width="1200" height="300"
         style="fill:none; stroke:blue; stroke-width:3"/&gt;
  &lt;g style="/* 規則 11 */ stroke-width:40"&gt;

    &lt;!-- <span title="Start of generated content. Replaces 'use'">'use' を置き換える生成内容はここから</span> --&gt;
    &lt;g style="/* 規則 1 */ fill:blue;
                 /* 規則 3 */ fill-opacity:.5;
                 /* 規則 5 */ stroke-linecap:round;
                 /* 規則 12 */ stroke-dashoffset:50" &gt;
      &lt;path d="M300 50 L900 50 L900 250 L300 250"
            style="/* 規則 2 */ stroke:red; 
                   /* 規則 4 */ stroke-opacity:.5; 
                   /* 規則 6 */ stroke-linejoin: bevel; 
                   /* 規則 10 */ stroke-dasharray:300,100" /&gt;
    &lt;/g&gt; 
    &lt;!-- <span title="End of generated content">生成内容はここまで</span> --&gt;

  &lt;/g&gt;
&lt;/svg&gt;</pre>
<p class="view-as-svg"><a href="images/struct/Use04-GeneratedContent.svg">この例を SVG で表示（ SVG 対応ブラウザのみ）</a></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が他の
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素もしくは
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素を内容に持つ他の要素を参照する場合、上で述べた末端までの複製処理は再帰的に行われる。
しかしながら，参照による連鎖が 直接的か間接的かを問わず循環した場合、
<a href="#Head">参照と <span class="element-name">defs</span> 要素</a>
にて述べたように，エラーとみなされる。
<span lang="en">
When a ‘use’ references another element which is another ‘use’ or whose content contains a ‘use’ element, then the deep cloning approach described above is recursive. However, a set of references that directly or indirectly reference a element to create a circular dependency is an error, as described in References and the ‘defs’ element.
</span></p>


<div class="adef-list">
  <p><em>属性定義</em></p>
  <dl><dt id="UseElementXAttribute"><span class="adef">x</span> = "<a href="types.html#DataTypeCoordinate"><span class="attr-value">&lt;coordinate&gt;</span></a>"</dt><dd>

<p class="T">
参照先の要素が配置される矩形の第一頂点の X 座標。
<span lang="en">
The x-axis coordinate of one corner of the rectangular region into which the referenced element is placed.
</span></p>


<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">0</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of "0" were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="UseElementYAttribute"><span class="adef">y</span> = "<a href="types.html#DataTypeCoordinate"><span class="attr-value">&lt;coordinate&gt;</span></a>"</dt><dd>

<p class="T">
参照先の要素が配置される矩形の第一頂点の Y 座標。
<span lang="en">
The y-axis coordinate of one corner of the rectangular region into which the referenced element is placed.
</span></p>


<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">0</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of "0" were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="UseElementWidthAttribute"><span class="adef">width</span> = "<a href="types.html#DataTypeLength"><span class="attr-value">&lt;length&gt;</span></a>"</dt><dd>

<p class="T">
参照先の要素が配置される矩形の幅。

負値はエラー（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
値をゼロにすると要素は描画されなくなる。
<span lang="en">
The width of the rectangular region into which the referenced element is placed. A negative value is an error (see Error processing). A value of zero disables rendering of this element.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="UseElementHeightAttribute"><span class="adef">height</span> = "<a href="types.html#DataTypeLength"><span class="attr-value">&lt;length&gt;</span></a>"</dt><dd>

<p class="T">
参照先の要素が配置される矩形の高さ。

負値はエラー（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
値をゼロにすると要素は描画されなくなる。
<span lang="en">
The height of the rectangular region into which the referenced element is placed. A negative value is an error (see Error processing). A value of zero disables rendering of this element.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="UseElementHrefAttribute"><span class="adef">xlink:href</span> = "<a href="types.html#DataTypeIRI"><span class="attr-value">&lt;iri&gt;</span></a>"</dt><dd>

<p class="T">
SVG 文書片または SVG 文書内の要素への
<a href="linking.html#IRIReference">IRI 参照</a>
。
<span lang="en">
A IRI reference to an element/fragment within an SVG document.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd></dl>
</div>


<h2 title="5.7 The ‘image’ element" id="ImageElement">5.7 <span class="element-name">image</span> 要素</h2>


<div class="element-summary"><div class="element-summary-name"><span class="element-name">image</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermGraphicsElement">グラフィックス要素</a>,
<a href="intro.html#TermGraphicsReferencingElement">グラフィックス参照要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
</ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermConditionalProcessingAttribute">条件付き処理属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a class="T-ex" href="intro.html#TermXLinkAttributes">xlink 属性</a><span>
<a href="struct.html#ImageElementHrefAttribute"><span class="attr-name">xlink:href</span></a></span></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a></li><li><a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a></li><li><a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a></li><li><a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a></li><li><a href="struct.html#ImageElementWidthAttribute"><span class="attr-name">width</span></a></li><li><a href="struct.html#ImageElementHeightAttribute"><span class="attr-name">height</span></a></li><li><a href="struct.html#ImageElementHrefAttribute"><span class="attr-name">xlink:href</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGImageElement">SVGImageElement</a></li></ul></dd></dl></div>

<p class="T">
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素はファイルの完全な中身を現在の利用座標系の与えられた矩形領域に描画させることを指示する。
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素は PNG や JPEG などのラスター画像のファイルあるいは、 MIME タイプ "image/svg+xml" のファイルを参照できる。
<a href="conform.html#ConformingSVGViewers">適合 SVG ビューア</a>
には少なくとも PNG, JPEG, SVG 形式のサポートが求められる。
<span lang="en">
The ‘image’ element indicates that the contents of a complete file are to be rendered into a given rectangle within the current user coordinate system. The ‘image’ element can refer to raster image files such as PNG or JPEG or to files with MIME type of "image/svg+xml". Conforming SVG viewers need to support at least PNG, JPEG and SVG format files.
</span></p>

<p class="T">
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の処理結果は必ず４チャンネル RGBA である。
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素が３チャンネル（ RGB ）のみを持つラスター画像のファイルを参照している場合、アルファ値が一様に 1 にされた４チャンネル RGBA に変換される。
１チャンネルのみのラスター画像の場合、３つの色チャンネル（ RGB ）の値が元の１チャンネルの値から算出され，アルファチャンネルが一様に 1 にされた４チャンネル RGBA に変換される。
<span lang="en">
The result of processing an ‘image’ is always a four-channel RGBA result. When an ‘image’ element references a raster image file such as PNG or JPEG files which only has three channels (RGB), then the effect is as if the object were converted into a 4-channel RGBA image with the alpha channel uniformly set to 1. For a single-channel raster image, the effect is as if the object were converted into a 4-channel RGBA image, where the single channel from the referenced object is used to compute the three color channels and the alpha channel is uniformly set to 1.
</span></p>

<p class="T">
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素は新規のビューポートを
<a href="coords.html#EstablishingANewViewport">新たなビューポートの確立</a>
で述べられるようにして確立する。
ビューポートの境界は属性
<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a>,
<a href="struct.html#ImageElementWidthAttribute"><span class="attr-name">width</span></a>,
<a href="struct.html#ImageElementHeightAttribute"><span class="attr-name">height</span></a>
で指定される。
参照先の画像の配置や拡縮率は
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性で制御される。
<span lang="en">
An ‘image’ element establishes a new viewport for the referenced file as described in Establishing a new viewport. The bounds for the new viewport are defined by attributes ‘x’, ‘y’, ‘width’ and ‘height’. The placement and scaling of the referenced image are controlled by the ‘preserveAspectRatio’ attribute on the ‘image’ element.
</span></p>

<p class="T">
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素が SVG 画像を参照する場合、 SVG 画像のルート要素の
<a href="masking.html#ClipProperty"><span class="prop-name">clip</span></a>,
<a href="masking.html#OverflowProperty"><span class="prop-name">overflow</span></a>
プロパティは無視される（
<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a>,
<a href="struct.html#ImageElementWidthAttribute"><span class="attr-name">width</span></a>,
<a href="struct.html#ImageElementHeightAttribute"><span class="attr-name">height</span></a>
属性が無視されるのと同じように）。
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
の値が 'defer' で開始されていない限り、参照先の SVG 画像のルート要素の
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性も無視される（詳細は
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
を見よ）。
その代わり、参照する
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性, 
<a href="masking.html#ClipProperty"><span class="prop-name">clip</span></a>,
<a href="masking.html#OverflowProperty"><span class="prop-name">overflow</span></a>
プロパティが，どのように SVG 画像をビューポートにはめ込み, どのようにクリッピングするか（またはしないか）を決定する。
<span lang="en">
When an ‘image’ element references an SVG image, the ‘clip’ and ‘overflow’ properties on the root element in the referenced SVG image are ignored (in the same manner as the ‘x’, ‘y’, ‘width’ and ‘height’ attributes are ignored). Unless the value of ‘preserveAspectRatio’ on the ‘image’ element starts with 'defer', the ‘preserveAspectRatio’ attribute on the root element in the referenced SVG image is also ignored (see ‘preserveAspectRatio’ for details). Instead, the ‘preserveAspectRatio’ attribute on the referencing ‘image’ element defines how the SVG image content is fitted into the viewport and the ‘clip’ and ‘overflow’ properties on the ‘image’ element define how the SVG image content is clipped (or not) relative to the viewport.<!-- PR -->
</span></p>

<p class="T">
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性の評価時に利用される
<a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a>
属性の値は、参照先の内容で定義される。
明白な viewBox を持つ内容（例えば
<a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a>
属性が
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に指定されている SVG ファイル）ならば、その値が利用されるべきである。
ほとんどのラスター画像（ PNG, JPEG ）では、画像の大きさが利用されるべきである（すなわち，
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素は暗黙の 'viewBox' の値： <span class="attr-value">'0, 0, ラスター画像の幅, ラスター画像の高さ'</span> を持つ）。
値が指定されていない場合（例えば
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に
<a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a>
属性が指定されていない SVG ファイル）、
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性は無視され，ビューポートの
<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a>
属性による変換のみが内容の表示に用いられる。
<span lang="en">
The value of the ‘viewBox’ attribute to use when evaluating the ‘preserveAspectRatio’ attribute is defined by the referenced content. For content that clearly identifies a viewBox (e.g. an SVG file with the ‘viewBox’ attribute on the outermost svg element) that value should be used. For most raster content (PNG, JPEG) the bounds of the image should be used (i.e. the ‘image’ element has an implicit ‘viewBox’ of '0 0 raster-image-width raster-image-height'). Where no value is readily available (e.g. an SVG file with no ‘viewBox’ attribute on the outermost svg element) the ‘preserveAspectRatio’ attribute is ignored, and only the translation due to the ‘x’ &amp; ‘y’ attributes of the viewport is used to display the content.<!-- PR -->
</span></p>

<p class="T">
例えば image 要素が PNG や JPEG を参照していて,
<span class="attr-value">preserveAspectRatio="xMinYMin meet"</span>
が指定されているならば、ラスターにおける縦横比は保たれる（画像の座標系から現在の利用座標系への X 軸方向と Y 軸方向の拡縮率は等しくなる）。
ラスターは
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の属性
<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a>,
<a href="struct.html#ImageElementWidthAttribute"><span class="attr-name">width</span></a>,
<a href="struct.html#ImageElementHeightAttribute"><span class="attr-name">height</span></a>
から定まるビューポートに収まる範囲内まで 可能な限り大きくされ、ラスターの左上隅はビューポートの左上隅に合わせられる。
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
の値が 'none' の場合、画像の縦横比は維持されない。
画像は ラスターの左上隅が座標
(<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a>,
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a>)
に，ラスターの右下隅が座標
(<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a> +
<a href="struct.html#ImageElementWidthAttribute"><span class="attr-name">width</span></a>,
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a> +
<a href="struct.html#ImageElementHeightAttribute"><span class="attr-name">height</span></a>)
に正確に揃うように，はめ込まれる。
<span lang="en">
For example, if the image element referenced a PNG or JPEG and preserveAspectRatio="xMinYMin meet", then the aspect ratio of the raster would be preserved (which means that the scale factor from image's coordinates to current user space coordinates would be the same for both X and Y), the raster would be sized as large as possible while ensuring that the entire raster fits within the viewport, and the top/left of the raster would be aligned with the top/left of the viewport as defined by the attributes ‘x’, ‘y’, ‘width’ and ‘height’ on the ‘image’ element. If the value of ‘preserveAspectRatio’ was 'none' then aspect ratio of the image would not be preserved. The image would be fitted such that the top/left corner of the raster exactly aligns with coordinate (‘x’, ‘y’) and the bottom/right corner of the raster exactly aligns with coordinate (‘x’+‘width’, ‘y’+‘height’).
</span></p>

<p class="T">
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素から参照されるリソースは、別個の，構文解析木と（リソースが XML ならば）文書オブジェクトモデルを持つ文書を表現する。
したがって，プロパティは、その画像へは継承されない。
<span lang="en">
The resource referenced by the ‘image’ element represents a separate document which generates its own parse tree and document object model (if the resource is XML). Thus, there is no inheritance of properties into the image.
</span></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素とは異なり，
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素は SVG ファイル内の要素を参照することはできない。
<span lang="en">
Unlike ‘use’, the ‘image’ element cannot reference elements within an SVG file.
</span></p>


    <div class="adef-list">
      <p><em>属性定義</em></p>
      <dl><dt id="ImageElementXAttribute"><span class="adef">x</span> = "<a href="types.html#DataTypeCoordinate"><span class="attr-value">&lt;coordinate&gt;</span></a>"</dt><dd>

<p class="T">
参照先の文書が配置される矩形の第一頂点の X 座標。
<span lang="en">
The x-axis coordinate of one corner of the rectangular region into which the referenced document is placed.
</span></p>


<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">0</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of '0' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="ImageElementYAttribute"><span class="adef">y</span> = "<a href="types.html#DataTypeCoordinate"><span class="attr-value">&lt;coordinate&gt;</span></a>"</dt><dd>

<p class="T">
参照先の文書が配置される矩形の第一頂点の Y 座標。
<span lang="en">
The y-axis coordinate of one corner of the rectangular region into which the referenced document is placed.
</span></p>


<p class="T">
この属性が指定されていない場合の効果は、値 <span class="attr-value">0</span> が指定されたときと同じになる。
<span lang="en">
If the attribute is not specified, the effect is as if a value of '0' were specified.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="ImageElementWidthAttribute"><span class="adef">width</span> = "<a href="types.html#DataTypeLength"><span class="attr-value">&lt;length&gt;</span></a>"</dt><dd>

<p class="T">
参照先の文書が配置される矩形の幅。
<span lang="en">
The width of the rectangular region into which the referenced document is placed.
</span></p>


<p class="T">
負値はエラー（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
値をゼロにすると要素は描画されなくなる。
<span lang="en">
A negative value is an error (see Error processing). A value of zero disables rendering of the element.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="ImageElementHeightAttribute"><span class="adef">height</span> = "<a href="types.html#DataTypeLength"><span class="attr-value">&lt;length&gt;</span></a>"</dt><dd>

<p class="T">
参照先の文書が配置される矩形の高さ。
<span lang="en">
The height of the rectangular region into which the referenced document is placed.
</span></p>


<p class="T">
負値はエラー（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
値をゼロにすると要素は描画されなくなる。
<span lang="en">
A negative value is an error (see Error processing). A value of zero disables rendering of the element.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="ImageElementHrefAttribute"><span class="adef">xlink:href</span> = "<a href="types.html#DataTypeIRI"><span class="attr-value">&lt;iri&gt;</span></a>"</dt><dd>

<p class="T">
<a href="linking.html#IRIReference">IRI 参照</a>
。
<span lang="en">
A IRI reference.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

</dd><dt id="ImageElementPreserveAspectRatioAttribute">
          <span class="adef">preserveAspectRatio</span> = "<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-value">[defer] &lt;align&gt; [&lt;meetOrSlice&gt;]</span></a>"
        </dt><dd>

<p class="T">
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
を見よ。
<span lang="en">
See ‘preserveAspectRatio’.
</span></p>

<p class="T">
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性が指定されていない場合の効果は、値 <span class="attr-value">xMidYMid meet</span> が指定されたときと同じになる。
<span lang="en">
If attribute ‘preserveAspectRatio’ is not specified, then the effect is as if a value of xMidYMid meet were specified.
</span></p>

<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>可</span>

        </dd></dl>
    </div>

<p class="T">
例：
<span lang="en">
An example:
</span></p>

<pre>&lt;?xml version="1.0" standalone="no"?&gt;
&lt;!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
  "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"&gt;
&lt;svg width="4in" height="3in" version="1.1"
     xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"&gt;
  &lt;desc&gt;<span title="This graphic links to an external image"
  >このグラフィックは外部の画像へリンクする</span>
  &lt;/desc&gt;
  &lt;image x="200" y="200" width="100px" height="100px"
         xlink:href="myimage.png"&gt;
    &lt;title&gt;My image&lt;/title&gt;
  &lt;/image&gt;
&lt;/svg&gt;
</pre>


<h2 title="5.8 Conditional processing" id="ConditionalProcessing">5.8 条件付き処理</h2>

    
<h3 title="5.8.1 Conditional processing overview" id="ConditionalProcessingOverview">5.8.1 条件付き処理の概観</h3>

<p class="T">
SVG には， UA の能力や利用者の言語環境に応じて代替表示を指定する機能を提供する
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素があり、
<dfn >条件付き処理属性</dfn>：
<a href="struct.html#RequiredFeaturesAttribute"><span class="attr-name">requiredFeatures</span></a>,
<a href="struct.html#RequiredExtensionsAttribute"><span class="attr-name">requiredExtensions</span></a>,
<a href="struct.html#SystemLanguageAttribute"><span class="attr-name">systemLanguage</span></a>
を伴って利用される。
<span lang="en">
SVG contains a ‘switch’ element along with attributes ‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ to provide an ability to specify alternate viewing depending on the capabilities of a given user agent or the user's language.
</span></p>

<p class="T">
条件付き処理属性は、一種のテストのように働くものであり，真または偽の値を返す。
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素は、その子要素のうち，これらの属性がすべて真と評価される 最初の子要素のみを描画する。
これらの属性のうち与えられていないものがあれば、それらの属性についての評価は 真とみなされる。
<span lang="en">
Attributes ‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ act as tests and return either true or false results. The ‘switch’ renders the first of its children for which all of these attributes test true. If the given attribute is not specified, then a true value is assumed.
</span></p>

<p class="T">
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
プロパティと同様、これらの条件付き処理属性は、要素の直接的描画にのみ影響し，（
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素などによる）要素から要素への参照には関与しない。
<span lang="en">
Similar to the ‘display’ property, conditional processing attributes only affect the direct rendering of elements and do not prevent elements from being successfully referenced by other elements (such as via a ‘use’).
</span></p>

<p class="T">
ゆえに，各種 条件付き処理属性は：
<span lang="en">
In consequence:
</span></p>

    <ul>

<li class="T">
<a href="linking.html#AElement"><span class="element-name">a</span></a>,
<a href="text.html#AltGlyphElement"><span class="element-name">altGlyph</span></a>,
<a href="extend.html#ForeignObjectElement"><span class="element-name">foreignObject</span></a>,
<a href="text.html#TextPathElement"><span class="element-name">textPath</span></a>,
<a href="text.html#TRefElement"><span class="element-name">tref</span></a>,
<a href="text.html#TSpanElement"><span class="element-name">tspan</span></a>
要素には影響する。
<span lang="en">
‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ attributes affect ‘a’, ‘altGlyph’, ‘foreignObject’, ‘textPath’, ‘tref’, and ‘tspan’ elements.
</span></li>

<li class="T">
<a href="masking.html#MaskElement"><span class="element-name">mask</span></a>,
<a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a>,
<a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a>
要素には影響しない。
<span lang="en">
‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ attributes will have no effect on ‘mask’, ‘clipPath’, and ‘pattern’ elements.
</span></li>

<li class="T">
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>,
<a href="interact.html#CursorElement"><span class="element-name">cursor</span></a>
要素には適用されない。
これらは描画木の一部ではない。
<span lang="en">
‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ attributes do not apply to the ‘defs’, and ‘cursor’ elements because they are not part of the rendering tree.
</span></li>

<li class="T">
<a href="animate.html#AnimateElement"><span class="element-name">animate</span></a>,
<a href="animate.html#AnimateColorElement"><span class="element-name">animateColor</span></a>,
<a href="animate.html#AnimateMotionElement"><span class="element-name">animateMotion</span></a>,
<a href="animate.html#AnimateTransformElement"><span class="element-name">animateTransform</span></a>,
<a href="animate.html#SetElement"><span class="element-name">set</span></a>
要素には影響する。
これらのアニメーション要素に対し 条件が満たされなかった場合、アニメーションは決して起動されない。
<span lang="en">
‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ attributes affect ‘animate’, ‘animateColor’, ‘animateMotion’, ‘animateTransform’, and ‘set’ elements. If the conditional statement on these animation elements fails, the animation will never be triggered.
</span></li>

</ul>

<h3 title="5.8.2 The ‘switch’ element" id="SwitchElement">5.8.2 <span class="element-name">switch</span> 要素</h3>

<div class="element-summary"><div class="element-summary-name"><span class="element-name">switch</span></div><dl><dt>分類：</dt><dd><a href="intro.html#TermContainerElement">コンテナ要素</a></dd>
<dt>内容モデル：</dt><dd>以下の要素の任意個数, 任意順序の組み合わせ：
<ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermAnimationElement">アニメーション要素</a></li>
<li><a class="T-ex" href="intro.html#TermDescriptiveElement">記述的要素</a></li>
<li><a class="T-ex" href="intro.html#TermShapeElement">図形要素</a></li>
<li><a href="linking.html#AElement"><span class="element-name">a</span></a></li><li><a href="extend.html#ForeignObjectElement"><span class="element-name">foreignObject</span></a></li><li><a href="struct.html#GElement"><span class="element-name">g</span></a></li><li><a href="struct.html#ImageElement"><span class="element-name">image</span></a></li><li><a href="struct.html#SVGElement"><span class="element-name">svg</span></a></li><li><a href="struct.html#SwitchElement"><span class="element-name">switch</span></a></li><li><a href="text.html#TextElement"><span class="element-name">text</span></a></li><li><a href="struct.html#UseElement"><span class="element-name">use</span></a></li></ul></dd><dt>属性：</dt><dd><ul class="no-bullets">
<li><a class="T-ex" href="intro.html#TermConditionalProcessingAttribute">条件付き処理属性</a></li>
<li><a class="T-ex" href="intro.html#TermCoreAttributes">中核属性</a></li>
<li><a class="T-ex" href="intro.html#TermGraphicalEventAttribute">グラフィカルイベント属性</a></li>
<li><a class="T-ex" href="intro.html#TermPresentationAttribute">呈示属性</a></li>
<li><a href="styling.html#ClassAttribute"><span class="attr-name">class</span></a></li><li><a href="styling.html#StyleAttribute"><span class="attr-name">style</span></a></li><li><a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a></li><li><a href="coords.html#TransformAttribute"><span class="attr-name">transform</span></a></li></ul></dd><dt>DOM インタフェース：</dt><dd><ul class="no-bullets"><li><a class="idlinterface" href="struct.html#InterfaceSVGSwitchElement">SVGSwitchElement</a></li></ul></dd></dl></div>

<p class="T">
<span class="element-name">switch</span>
要素は、その直接の子要素に対し順に，各種 条件付き処理属性を評価し、それらがすべて真となる最初の子要素に対してのみ，その処理と描画を行う。
他の要素は無視され、描画されない。
子要素が
<a href="struct.html#GElement"><span class="element-name">g</span></a>
であったとしても、その部分木全体が，処理されるか無視されるか — したがって，描画されるかされないか — のどちらかになる。
<span lang="en">
The ‘switch’ element evaluates the ‘requiredFeatures’, ‘requiredExtensions’ and ‘systemLanguage’ attributes on its direct child elements in order, and then processes and renders the first child for which these attributes evaluate to true. All others will be bypassed and therefore not rendered. If the child element is a container element such as a ‘g’, then the entire subtree is either processed/rendered or bypassed/not rendered.
</span></p>

<p class="T">
注記：
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>,
<a href="painting.html#VisibilityProperty"><span class="prop-name">visibility</span></a>
プロパティの値は，
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素の処理には影響しない。
特に、
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素の子の
<a href="painting.html#DisplayProperty"><span class="prop-name">display</span></a>
を
<span class="prop-value">none</span>
に設定しても，
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素による真偽テストには無関係である。
<span lang="en">
Note that the values of properties ‘display’ and ‘visibility’ have no effect on ‘switch’ element processing. In particular, setting ‘display’ to none on a child of a ‘switch’ element has no effect on true/false testing associated with ‘switch’ element processing.
</span></p>

<p class="T">
更なる詳細と例は
<a href="extend.html#EmbeddingForeignObjects">外部の型のオブジェクトの埋め込み</a>
を見よ。
<!-- href="extend.html#ForeignObjectElement" -->
<span lang="en">
For more information and an example, see Embedding foreign object types.
</span></p>


<h3 title="5.8.3 The ‘requiredFeatures’ attribute" id="ConditionalProcessingRequiredFeaturesAttribute">5.8.3 <span class="attr-name">requiredFeatures</span> 属性</h3>
    <div class="adef-list">

<p class="T">
<span class="adef">requiredFeatures</span>
の定義：
<span lang="en">
Definition of requiredFeatures:
</span></p>

      <dl><dt id="RequiredFeaturesAttribute"><span class="adef">requiredFeatures</span> =
        <em>list-of-features</em></dt><dd>

<p class="T">
値は空白で区切られた特能文字列のリスト。
指定されたすべての<em>特能</em>について， UA でサポートされているかどうかが調べられる。
特能文字列には、付録の
<a href="feature.html">特能文字列</a>
にて定義されるもののみを指定できる。
すべての特能がサポートされていれば，この属性は真と評価され、それ以外の場合，要素はその子要素もひっくるめて無視され，描画されない。
<span lang="en">
The value is a list of feature strings, with the individual values separated by white space. Determines whether all of the named features are supported by the user agent. Only feature strings defined in the Feature String appendix are allowed. If all of the given features are supported, then the attribute evaluates to true; otherwise, the current element and its children are skipped and thus will not be rendered.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd></dl>
    </div>

<p class="T">
この属性が与えられていない場合、暗黙に真と評価される。
この属性に null 文字列または空文字列が指定された場合、偽と評価される。
<span lang="en">
If the attribute is not present, then its implicit return value is "true". If a null string or empty string value is given to attribute ‘requiredFeatures’, the attribute returns "false".
</span></p>

<p class="T">
<a href="struct.html#RequiredFeaturesAttribute"><span class="attr-name">requiredFeatures</span></a>
は通常，
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素と伴用される。
<a href="struct.html#RequiredFeaturesAttribute"><span class="attr-name">requiredFeatures</span></a>
が他の局面で用いられた場合、その要素を描画するか／しないかの単純なスイッチになる。
<span lang="en">
‘requiredFeatures’ is often used in conjunction with the ‘switch’ element. If the ‘requiredFeatures’ is used in other situations, then it represents a simple switch on the given element whether to render the element or not.
</span></p>

<h3 title="5.8.4 The ‘requiredExtensions’ attribute" id="ConditionalProcessingRequiredExtensionsAttribute">5.8.4 <span class="attr-name">requiredExtensions</span> 属性</h3>

<p class="T">
<a href="struct.html#RequiredExtensionsAttribute"><span class="attr-name">requiredExtensions</span></a>
属性は必要な言語拡張のリストを指定する。
言語拡張は，この仕様で定められている特能の範囲外であり、 UA の機能の範疇である。
個々の言語拡張は
<a href="linking.html#IRIReference">IRI 参照</a>
により指定される。
<span lang="en">
The ‘requiredExtensions’ attribute defines a list of required language extensions. Language extensions are capabilities within a user agent that go beyond the feature set defined in this specification. Each extension is identified by an IRI reference.
</span></p>

    <div class="adef-list">

<p class="T">
<span class="adef">requiredExtensions</span> の定義：
<span lang="en">
Definition of requiredExtensions:
</span></p>

      <dl><dt id="RequiredExtensionsAttribute"><span class="adef">requiredExtensions</span> =
        <em>list-of-extensions</em></dt><dd>

<p class="T">
値は，要求される拡張を指定する
<a href="linking.html#IRIReference">IRI 参照</a>
の空白区切りのリスト。
指定されたすべての<em>拡張</em>について， UA でサポートされているかどうかが調べられる。
すべての拡張がサポートされていれば，この属性は真と評価され、それ以外の場合，要素はその子要素もひっくるめて無視され，描画されない。
<span lang="en">
The value is a list of IRI references which identify the required extensions, with the individual values separated by white space. Determines whether all of the named extensions are supported by the user agent. If all of the given extensions are supported, then the attribute evaluates to true; otherwise, the current element and its children are skipped and thus will not be rendered.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd></dl>
    </div>

<p class="T">
<a href="linking.html#IRIReference">IRI 参照</a>
に含まれる空白は，エスケープされていなければならない。
<span lang="en">
If a given IRI reference contains white space within itself, that white space must be escaped.
</span></p>

<p class="T">
この属性が与えられていない場合、暗黙に真と評価される。
この属性に null 文字列または空文字列が指定された場合、偽と評価される。
<span lang="en">
If the attribute is not present, then its implicit return value is "true". If a null string or empty string value is given to attribute ‘requiredExtensions’, the attribute returns "false".
</span></p>

<p class="T">
<a href="struct.html#RequiredExtensionsAttribute"><span class="attr-name">requiredExtensions</span></a>
は通常
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素と伴用される。
<a href="struct.html#RequiredExtensionsAttribute"><span class="attr-name">requiredExtensions</span></a>
が他の局面で用いられた場合、その要素を描画するか／しないかの単純なスイッチになる。
<span lang="en">
‘requiredExtensions’ is often used in conjunction with the ‘switch’ element. If the ‘requiredExtensions’ is used in other situations, then it represents a simple switch on the given element whether to render the element or not.
</span></p>

<p class="T">
拡張の IRI 名はスクリプトの書き手が異なるバージョンを区別できるようにするため、
"http://example.org/SVGExtensionXYZ/1.0"
のように，バージョン情報も含められるべきである。
<span lang="en">
The IRI names for the extension should include versioning information, such as "http://example.org/SVGExtensionXYZ/1.0", so that script writers can distinguish between different versions of a given extension.
</span></p>


<h3 title="5.8.5 The ‘systemLanguage’ attribute" id="ConditionalProcessingSystemLanguageAttribute">5.8.5 <span class="attr-name">systemLanguage</span> 属性</h3>

<p class="T" id="SystemLanguageAttribute">
この属性の値は、
<a href="http://www.ietf.org/rfc/bcp/bcp47.txt">BCP 47</a>
[<a href="refs.html#ref-BCP47">BCP47</a>]
で定められている言語名のコンマ区切りのリストである。
<span lang="en">
The attribute value is a comma-separated list of language names as defined in BCP 47 [BCP47].
</span></p>

<p class="T">
利用者の環境で設定されている言語の一つが、この属性で指定された言語（の文字列），あるいはその接頭辞（接頭辞に続く最初のタグ区切り文字が "-"）に完全に一致するならば，真と評価される。
<span lang="en">
Evaluates to "true" if one of the languages indicated by user preferences exactly equals one of the languages given in the value of this parameter, or if one of the languages indicated by user preferences exactly equals a prefix of one of the languages given in the value of this parameter such that the first tag character following the prefix is "-".
</span></p>

<p class="T">
他の場合、偽と評価される。
<span lang="en">
Evaluates to "false" otherwise.
</span></p>

<p class="T">
注記：
この一致規則の利用があるからと言って、言語に対応する言語タグの割り当てが、利用者がなんらかのタグの言語を理解するならば，そのタグを接頭子とするすべてのタグの言語も理解する形で 行われていることを意味するわけではない。
<span lang="en">
Note: This use of a prefix matching rule does not imply that language tags are assigned to languages in such a way that it is always true that if a user understands a language with a certain tag, then this user will also understand all languages with tags for which this tag is a prefix.
</span></p>

<p class="T">
この接頭子一致規則は単純にそのような用法を許容しているに過ぎない。
<span lang="en">
The prefix rule simply allows the use of prefix tags if this is the case.
</span></p>

<p class="T">
実装上の注記：言語について利用者の選好による設定を可能にする場合、実装者は「利用者が上記の言語一致規則の詳細について知らない」ことを念頭に置いて，適切なガイドを提供すべきである。
例えば、利用者は「 "en-gb" を選択しておけば，すべての英語文書は英国英語でなくとも利用できる」と考えるかもしれない。
言語設定のユーザインタフェースでは「最良の言語一致のためには，（"en-gb" に加えて）"en" も追加すべきである」旨を示唆すべきである。
<span lang="en">
Implementation note: When making the choice of linguistic preference available to the user, implementers should take into account the fact that users are not familiar with the details of language matching as described above, and should provide appropriate guidance. As an example, users may assume that on selecting "en-gb", they will be served any kind of English document if British English is not available. The user interface for setting user preferences should guide the user to add "en" to get the best matching behavior.
</span></p>

<p class="T">
複数人による同時視聴を意図する内容のために、複数の言語を含めても<em>よい</em>。
例えば、元のマオリ語に加え, 英語も同時に表現できる内容は、次のように書かれるであろう：
<span lang="en">
Multiple languages MAY be listed for content that is intended for multiple audiences. For example, content that is presented simultaneously in the original Maori and English versions, would call for:
</span></p>


<p style="text-align:center;">
	<code>&lt;text systemLanguage="mi, en"&gt;&lt;!-- content goes here --&gt;&lt;/text&gt;</code>
</p>

<p class="T">
しかしながら、
<a href="struct.html#SystemLanguageAttribute"><span class="attr-name">systemLanguage</span></a>
テスト属性の付いたオブジェクトに複数の言語が用意されているからと言って、複数言語に渡る視聴者向けになるとは限らない。
例えば  “A First Lesson in Latin” （ラテン語第一講）の様な，英語を母語とする読者向けであることが明白な 初心者向け言語入門など。
このような場合、
<a href="struct.html#SystemLanguageAttribute"><span class="attr-name">systemLanguage</span></a>
テスト属性は "en" のみを含むべきである。
<span lang="en">
However, just because multiple languages are present within the object on which the ‘systemLanguage’ test attribute is placed, this does not mean that it is intended for multiple linguistic audiences. An example would be a beginner's language primer, such as "A First Lesson in Latin," which is clearly intended to be used by an English-literate audience. In this case, the ‘systemLanguage’ test attribute should only include "en".
</span></p>

<p class="T">
文書作成者への注記：
文書作成者は、
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素に含まれている複数の代替言語のオブジェクトが どれも表示されない可能性を考慮に入れるべきである。
したがって
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素の最後に、いかなる場合にも受け入れられる「万能選手」を含めておくことが推奨される。
<span lang="en">
Authoring note: Authors should realize that if several alternative language objects are enclosed in a ‘switch’, and none of them matches, this may lead to situations where no content is displayed. It is thus recommended to include a "catch-all" choice at the end of such a ‘switch’ which is acceptable in all cases.
</span></p>

<p class="T">
<a href="struct.html#SystemLanguageAttribute"><span class="attr-name">systemLanguage</span></a>
属性に対しては：
<span lang="en">
For the ‘systemLanguage’:
</span></p>

<p>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span></p>

<p class="T">
この属性が与えられていない場合、暗黙に真と評価される。
この属性に null 文字列または空文字列が指定された場合、偽と評価される。
<span lang="en">
If the attribute is not present, then its implicit return value is "true". If a null string or empty string value is given to attribute ‘systemLanguage’, the attribute returns "false".
</span></p>

<p class="T">
<a href="struct.html#SystemLanguageAttribute"><span class="attr-name">systemLanguage</span></a>
は通常
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素と伴用される。
<a href="struct.html#SystemLanguageAttribute"><span class="attr-name">systemLanguage</span></a>
が他の局面で用いられた場合、その要素を描画するか／しないかの単純なスイッチになる。
<span lang="en">
‘systemLanguage’ is often used in conjunction with the ‘switch’ element. If the ‘systemLanguage’ is used in other situations, then it represents a simple switch on the given element whether to render the element or not.
</span></p>


<h3 title="5.8.6 Applicability of test attributes" id="ApplicabilityOfTestAttributes">5.8.6 テスト属性の適用性</h3>

<p class="T">
直接的に描画されない要素に対するテスト属性の適用の可否を次に挙げる：
<span lang="en">
The following list describes the applicability of the test attributes to the elements that do not directly produce rendering.
</span></p>

    <ul>

<li class="T">
テスト属性は
<a href="masking.html#MaskElement"><span class="element-name">mask</span></a>,
<a href="masking.html#ClipPathElement"><span class="element-name">clipPath</span></a>,
<a href="pservers.html#LinearGradientElement"><span class="element-name">linearGradient</span></a>,
<a href="pservers.html#RadialGradientElement"><span class="element-name">radialGradient</span></a>,
<a href="pservers.html#PatternElement"><span class="element-name">pattern</span></a>
要素には適用されない。
参照先の要素のテスト属性は参照元の要素の描画に影響しない。
<span lang="en">
the test attributes do not effect the ‘mask’, ‘clipPath’, ‘linearGradient’, ‘radialGradient’ and ‘pattern’ elements. The test attributes on a referenced element do not affect the rendering of the referencing element.
</span></li>

<li class="T">
テスト属性は
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>,
<a href="interact.html#CursorElement"><span class="element-name">cursor</span></a>
要素には適用されない。
これらは描画木の一部ではない。
<span lang="en">
the test attributes do not effect the ‘defs’, and ‘cursor’ elements as they are not part of the rendering tree.
</span></li>

<li class="T">
アニメーション要素（
<a href="animate.html#AnimateElement"><span class="element-name">animate</span></a>,
<a href="animate.html#AnimateMotionElement"><span class="element-name">animateMotion</span></a>,
<a href="animate.html#AnimateTransformElement"><span class="element-name">animateTransform</span></a>,
<a href="animate.html#AnimateColorElement"><span class="element-name">animateColor</span></a>,
<a href="animate.html#SetElement"><span class="element-name">set</span></a>
）に偽と評価されるテスト属性が存在した場合、決して起動されない。
<span lang="en">
an animation element (‘animate’, ‘animateMotion’, ‘animateTransform’, ‘animateColor’ and ‘set’) will never be triggered if it has a test attribute that evaluates to false.
</span></li>

</ul>

<h2 title="5.9 Specifying whether external resources are required for proper rendering" id="ExternalResourcesRequired">5.9 文書の正当な描画に欠かせない外部リソースの指定</h2>

<p class="T">
文書はしばしば、他のファイル（他のウェブリソース）を描画の一部として参照利用する。
文書作成者にとっては、他のリソースの存在が文書の正当性に欠かせないかどうか指定したい場合もある。
<span lang="en">
Documents often reference and use the contents of other files (and other Web resources) as part of their rendering. In some cases, authors want to specify that particular resources are required for a document to be considered correct.
</span></p>

<p class="T">
<a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a>
属性は、すべてのコンテナ要素，および 外部リソースを参照し得るすべての要素に利用できる。
参照先の外部リソースが，与えられたコンテナ要素／グラフィックス要素の正当な描画に欠かせないものかどうかを、この属性で指定できる。
<span lang="en">
Attribute ‘externalResourcesRequired’ is available on all container elements and to all elements which potentially can reference external resources. It specifies whether referenced resources that are not part of the current document are required for proper rendering of the given container element or graphics element.
</span></p>

    <div class="adef-list">
      <p><em>属性定義</em></p>

      <dl><dt id="ExternalResourcesRequiredAttribute"><span class="adef">externalResourcesRequired</span> =
        "<span class="attr-value">false | true</span>"</dt><dd>
          <dl><dt><span class="attr-value">false</span></dt>

<dd class="T">
（既定値）外部リソースは 省略可能であることを指示する。
描画処理は、外部リソースが現在の要素もしくはその子孫において入手できなくても，続行される。
<span lang="en">
(The default value.) Indicates that resources external to the current document are optional. Document rendering can proceed even if external resources are unavailable to the current element and its descendants.
</span>
</dd>
<dt><span class="attr-value">true</span></dt>

<dd class="T">
外部リソースが欠かせないことを指示する。
外部リソースが入手できない場合、進行中の描画処理は中断され，文書の
<a href="interact.html#LoadEvent">SVGLoad</a>
イベントは発火されず，アニメーションは そのリソースとすべての必要なリソースが 入手され, 解釈され, 描画準備が完了するまで 開始されない。
もし必要なリソースで時間切れイベントが生じた場合、文書はエラー状態になる（
<a href="implnote.html#ErrorProcessing">エラー処理</a>
を見よ）。
エラー状態は、必要なリソースが可用になるまで解除されない。
<span lang="en">
Indicates that resources external to the current document are required. If an external resource is not available, progressive rendering is suspended, the document's SVGLoad event is not fired and the animation timeline does not begin until that resource and all other required resources become available, have been parsed and are ready to be rendered. If a timeout event occurs on a required resource, then the document goes into an error state (see Error processing). The document remains in an error state until all required resources become available.
</span>
</dd>
</dl>
        </dd></dl>
    </div>

<p class="T">
この属性は、スタイルシート, カラープロファイル（
<a href="color.html#ColorProfileDescriptions">カラープロファイル記述</a>
を見よ）,
<a href="fonts.html#FontFaceElement"><span class="element-name">font-face</span></a>
要素による
<a href="intro.html#TermIRIReference">IRI 参照</a>
で指定されるフォント, CSS @font-face で指定されるフォントを含む，すべての種類のリソース参照に適用できる。
特に
<span class="attr-value">externalResourcesRequired="true"</span>
に設定された要素が存在する場合、すべてのスタイルシートが可用でなければならない。
なぜなら、どのスタイルシートも要素の描画に影響し得るからである。
<span lang="en">
This attribute applies to all types of resource references, including style sheets, color profiles (see Color profile descriptions) and fonts specified by an IRI reference using a ‘font-face’ element or a CSS @font-face specification. In particular, if an element sets externalResourcesRequired="true", then all style sheets must be available since any style sheet might affect the rendering of that element.
</span></p>

<p class="T">
<a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a>
属性は（属性値の継承の意味で）継承できないが、コンテナ要素に使用された場合は，含まれるすべての要素に適用される。
<span lang="en">
Attribute ‘externalResourcesRequired’ is not inheritable (from a sense of attribute value inheritance), but if set on a container element, its value will apply to all elements within the container.
</span></p>

<p class="T">
外部リソースを参照する要素を含んでいるコンテナ要素において
<span class="attr-value">externalResourcesRequired="true"</span>
に指定されている場合、コンテナ内容の漸進的な表示は無効になる。
従って SVG 内容を生成するツール類は、通常の一般動作として単に
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
に
<span class="attr-value">externalResourcesRequired="true"</span>
を指定するようなことは避けるべきであり，外部リソースの存在が描画の正しさに特に欠かせないような特定のグラフィックス要素やコンテナ要素に対してのみ，
<span class="attr-value">externalResourcesRequired="true"</span>
を指定する方がよい。
<span lang="en">
Because setting externalResourcesRequired="true" on a container element will have the effect of disabling progressive display of the contents of that container, if that container includes elements that reference external resources, tools that generate SVG content are cautioned against simply setting externalResourcesRequired="true" on the outermost svg element on a universal basis. Instead, it is better to specify externalResourcesRequired="true" on those particular graphics elements or container elements which specifically need the availability of external resources in order to render properly.
</span></p>

<p class="T">
<a href="struct.html#ExternalResourcesRequiredAttribute"><span class="attr-name">externalResourcesRequired</span></a>
属性に対しては：
<span lang="en">
For externalResourcesRequired:
</span></p>

<p>
<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span></p>


<h2 title="5.10 Common attributes" id="CommonAttributes">5.10 共通属性</h2>

<h3 title="5.10.1 Attributes common to all elements: ‘id’ and ‘xml:base’" id="Core.attrib">5.10.1 すべての要素に共通の属性： <span class="attr-name">id</span> と <span class="attr-name">xml:base</span></h3>

<p class="T">
<a href="struct.html#IDAttribute"><span class="attr-name">id</span></a>
属性と
<a href="struct.html#XMLBaseAttribute"><span class="attr-name">xml:base</span></a>
属性はすべての SVG 要素で利用できる：
<span lang="en">
The ‘id’ and ‘xml:base’ attributes are available on all SVG elements:
</span></p>

    <div class="adef-list">
      <p><em>属性定義</em></p>
      <dl><dt id="IDAttribute"><span class="adef">id</span> = "<span class="attr-value">name</span>"</dt><dd>

<p class="T">
要素に一意的な<em >名前</em>を与えるための標準 XML 属性。
<a href="http://www.w3.org/TR/2008/REC-xml-20081126/"><cite>Extensible Markup Language (XML) 1.0</cite></a>
勧告
[<a href="http://www.w3.org/TR/REC-xml/">XML10</a>]
を参照のこと。
<span lang="en">
Standard XML attribute for assigning a unique name to an element. Refer to the Extensible Markup Language (XML) 1.0 Recommendation [XML10].
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd><dt id="XMLBaseAttribute"><span class="adef">xml:base</span> = "<a href="types.html#DataTypeIRI"><span class="attr-value">&lt;iri&gt;</span></a>"</dt><dd>

<p class="T">
文書または外部実体の基底 IRI 以外の基底 IRI を指定する。
<a href="http://www.w3.org/TR/2009/REC-xmlbase-20090128/"><cite>XML Base</cite></a>
仕様
[<a href="refs.html#ref-XML-BASE">XML-BASE</a>]
を参照のこと。
<span lang="en">
Specifies a base IRI other than the base IRI of the document or external entity. Refer to the XML Base specification [XML-BASE].
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd></dl>
    </div>

<h3 title="5.10.2 The ‘xml:lang’ and ‘xml:space’ attributes" id="LangSpaceAttrs">5.10.2 <span class="attr-name">xml:lang</span> and <span class="attr-name">xml:space</span> 属性</h3>

<p class="T">
文字データ内容を含み得る要素は，
<a href="struct.html#XMLLangAttribute"><span class="attr-name">xml:lang</span></a>
属性と
<a href="struct.html#XMLSpaceAttribute"><span class="attr-name">xml:space</span></a>
属性を持つことができる：
<span lang="en">
Elements that might contain character data content have attributes ‘xml:lang’ and ‘xml:space’.
</span></p>

    <div class="adef-list">
      <p><em>属性定義</em></p>
      <dl><dt id="XMLLangAttribute"><span class="adef">xml:lang</span> = "<span class="attr-value">languageID</span>"</dt><dd>

<p class="T">
内容や属性に利用される言語（例えば英語）を指定する標準 XML 属性。
<a href="http://www.w3.org/TR/2008/REC-xml-20081126/"><cite>Extensible Markup Language (XML) 1.0</cite></a>
勧告
[<a href="http://www.w3.org/TR/REC-xml/">XML10</a>]
を参照のこと。
<span lang="en">
Standard XML attribute to specify the language (e.g., English) used in the contents and attribute values of particular elements. Refer to the Extensible Markup Language (XML) 1.0 Recommendation [XML10].
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd><dt id="XMLSpaceAttribute"> <span class="adef">xml:space</span> = "<span class="attr-value">{default | preserve}</span>"</dt><dd>

<p class="T">
文字データの空白を保持するかどうかを指定する標準 XML 属性。
<span class="attr-value">default</span> および <span class="attr-value">preserve</span> のみが値として許される。
<a href="http://www.w3.org/TR/2008/REC-xml-20081126/"><cite>Extensible Markup Language (XML) 1.0</cite></a>
勧告
[<a href="http://www.w3.org/TR/REC-xml/">XML10</a>]
を参照のこと。
加えて、 SVG における
<a href="text.html#WhiteSpace">空白の扱い</a>
も見よ。
<span lang="en">
Standard XML attribute to specify whether white space is preserved in character data. The only possible values are 'default' and 'preserve'. Refer to the Extensible Markup Language (XML) 1.0 Recommendation [XML10] and to the discussion white space handling in SVG.
</span></p>


<span class="anim-target"><a href="animate.html#Animatable">アニメーション：</a>不可</span>

</dd></dl>
    </div>

<h2 title="5.11 DOM interfaces" id="DOMInterfaces">5.11 DOM インタフェース</h2>

<h3 title="5.11.1 Interface SVGDocument" id="InterfaceSVGDocument">5.11.1 インタフェース SVGDocument</h3>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素が， XHTML 文書
[<a href="refs.html#ref-XHTML">XHTML</a>]
などの他の名前空間の文書の部品として, インラインに埋め込まれている場合、
<a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a>
オブジェクトは存在せず，代わりに文書オブジェクト階層のルートオブジェクトは HTMLDocument オブジェクトなどの，異なる型の文書オブジェクトになる。
<span lang="en">
When an ‘svg’ element is embedded inline as a component of a document from another namespace, such as when an ‘svg’ element is embedded inline within an XHTML document [XHTML], then an SVGDocument object will not exist; instead, the root object in the document object hierarchy will be a Document object of a different type, such as an HTMLDocument object.
</span></p>

<p class="T">
一方で、独立 SVG ファイル（すなわち MIME タイプ "image/svg+xml" のファイル）を閲覧しているときの様に， XML 文書階層におけるルート要素が
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素である場合、
<a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a>
オブジェクトが実際に存在する。
この場合の
<a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a>
オブジェクトは，文書オブジェクトモデル階層のルートオブジェクトになる。
<span lang="en">
However, an SVGDocument object will indeed exist when the root element of the XML document hierarchy is an ‘svg’ element, such as when viewing a stand-alone SVG file (i.e., a file with MIME type "image/svg+xml"). In this case, the SVGDocument object will be the root object of the document object model hierarchy.
</span></p>

<p class="T">
XHTML 文書が
<span class="element-name">object</span>
要素を持ち, その
<span class="attr-name">href</span>
属性が SVG 文書（すなわち MIME タイプ "image/svg+xml" のファイルであり，したがってそのルート要素が
<span class="element-name">svg</span>
要素）を参照しているときなど， SVG 文書が参照を介して埋め込まれている場合、２つの別々の DOM 階層が存在することになる。
一つは参照している文書のもの（例えば XHTML 文書）であり, もう一つは参照先の SVG 文書のものになる。
後者におけるルートオブジェクトは
<a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a>
オブジェクトである。
<span lang="en">
In the case where an SVG document is embedded by reference, such as when an XHTML document has an ‘object’ element whose ‘href’ attribute references an SVG document (i.e., a document whose MIME type is "image/svg+xml" and whose root element is thus an ‘svg’ element), there will exist two distinct DOM hierarchies. The first DOM hierarchy will be for the referencing document (e.g., an XHTML document). The second DOM hierarchy will be for the referenced SVG document. In this second DOM hierarchy, the root object of the document object model hierarchy is an SVGDocument object.
</span></p>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a>
インタフェースは
[<a href="refs.html#ref-DOM1">DOM1</a>]
仕様の
<a href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-html.html">文書オブジェクトモデル (HTML) レベル 1</a>
の HTMLDocument インタフェースと類似する，属性とメソッドのリストを含んでいる。
<span lang="en">
The SVGDocument interface contains a similar list of attributes and methods to the HTMLDocument interface described in the Document Object Model (HTML) Level 1 chapter of the [DOM1] specification.
</span></p>

<pre class="idl">interface <b>SVGDocument</b> : <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#i-Document">Document</a>,
                        <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-DocumentEvent">DocumentEvent</a> {
  readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__title">title</a>;
  readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__referrer">referrer</a>;
  readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__domain">domain</a>;
  readonly attribute DOMString <a href="struct.html#__svg__SVGDocument__URL">URL</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a> <a href="struct.html#__svg__SVGDocument__rootElement">rootElement</a>;
};</pre><dl class="interface"><dt>属性</dt><dd><dl class="attributes">
<dt id="__svg__SVGDocument__title"><b>title</b><span class="idl-type-parenthetical"> (readonly DOMString)</span></dt><dd>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
ルート要素の
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
子要素で指定される文書のタイトル（すなわち <span class="code-fragment">&lt;svg&gt;&lt;title&gt;Here is the title&lt;/title&gt;...&lt;/svg&gt;</span> ）
<span lang="en">
The title of a document as specified by the ‘title’ sub-element of the ‘svg’ root element (i.e., &lt;svg&gt;&lt;title&gt;Here is the title&lt;/title&gt;...&lt;/svg&gt;)
</span></p>

</dd>
<dt id="__svg__SVGDocument__referrer"><b>referrer</b><span class="idl-type-parenthetical"> (readonly DOMString)</span></dt><dd>

<p class="T">
このページにリンクするページの URI 。
利用者が直接的にページを開いた場合の値は空文字列になる（リンクを通してではなく，例えばブックマークなどから）。
<span lang="en">
Returns the URI of the page that linked to this page. The value is an empty string if the user navigated to the page directly (not through a link, but, for example, via a bookmark).
</span></p>

</dd>
<dt id="__svg__SVGDocument__domain"><b>domain</b><span class="idl-type-parenthetical"> (readonly DOMString)</span></dt><dd>

<p class="T">
文書を供するサーバのドメイン名，あるいはドメイン名からサーバが特定できない場合は null 文字列。
<span lang="en">
The domain name of the server that served the document, or a null string if the server cannot be identified by a domain name.
</span></p>

</dd>
<dt id="__svg__SVGDocument__URL"><b>URL</b><span class="idl-type-parenthetical"> (readonly DOMString)</span></dt><dd>

<p class="T">
文書の完全な URI 。
<span lang="en">
The complete URI of the document.
</span></p>

</dd>
<dt id="__svg__SVGDocument__rootElement"><b>rootElement</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a>)</span></dt><dd>

<p class="T">
文書階層におけるルートの
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素。
<span lang="en">
The root ‘svg’ in the document hierarchy.
</span></p>

</dd></dl></dd></dl>

<h3 title="5.11.2 Interface SVGSVGElement" id="InterfaceSVGSVGElement">5.11.2 インタフェース SVGSVGElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a>
インタフェースは、
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に対応する，基本的なインタフェースである。
このインタフェースは、行列演算や視覚描画装置に対する再描画の時間的制御など，有用かつ多方面に共通して利用される様々なメソッドを含む。
<span lang="en">
A key interface definition is the SVGSVGElement interface, which is the interface that corresponds to the ‘svg’ element. This interface contains various miscellaneous commonly-used utility methods, such as matrix operations and the ability to control the time of redraw on visual rendering devices.
</span></p>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a>
は
<a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-ViewCSS">ViewCSS</a>
と
<a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-DocumentCSS">DocumentCSS</a>
を拡張し、プロパティの算出値へのアクセスと
<a href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/"><cite>DOM Level 2 Style</cite></a>
[<a href="refs.html#ref-DOM2STYLE">DOM2STYLE</a>]
で述べられているスタイルシートの上書きを提供する。
<span lang="en">
SVGSVGElement extends ViewCSS and DocumentCSS to provide access to the computed values of properties and the override style sheet as described in DOM Level 2 Style [DOM2STYLE].
</span></p>

<pre class="idl">interface <b>SVGSVGElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGTests">SVGTests</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGLocatable">SVGLocatable</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGFitToViewBox">SVGFitToViewBox</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGZoomAndPan">SVGZoomAndPan</a>,
                          <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-DocumentEvent">DocumentEvent</a>,
                          <a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-ViewCSS">ViewCSS</a>,
                          <a class="idlinterface" href="http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113/css.html#CSS-DocumentCSS">DocumentCSS</a> {

  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGSVGElement__x">x</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGSVGElement__y">y</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGSVGElement__width">width</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGSVGElement__height">height</a>;
           attribute DOMString <a href="struct.html#__svg__SVGSVGElement__contentScriptType">contentScriptType</a> setraises(<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-17189187">DOMException</a>);
           attribute DOMString <a href="struct.html#__svg__SVGSVGElement__contentStyleType">contentStyleType</a> setraises(<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-17189187">DOMException</a>);
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> <a href="struct.html#__svg__SVGSVGElement__viewport">viewport</a>;
  readonly attribute float <a href="struct.html#__svg__SVGSVGElement__pixelUnitToMillimeterX">pixelUnitToMillimeterX</a>;
  readonly attribute float <a href="struct.html#__svg__SVGSVGElement__pixelUnitToMillimeterY">pixelUnitToMillimeterY</a>;
  readonly attribute float <a href="struct.html#__svg__SVGSVGElement__screenPixelToMillimeterX">screenPixelToMillimeterX</a>;
  readonly attribute float <a href="struct.html#__svg__SVGSVGElement__screenPixelToMillimeterY">screenPixelToMillimeterY</a>;
  readonly attribute boolean <a href="struct.html#__svg__SVGSVGElement__useCurrentView">useCurrentView</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGViewSpec">SVGViewSpec</a> <a href="struct.html#__svg__SVGSVGElement__currentView">currentView</a>;
           attribute float <a href="struct.html#__svg__SVGSVGElement__currentScale">currentScale</a>;
  readonly attribute <a class="idlinterface" href="coords.html#InterfaceSVGPoint">SVGPoint</a> <a href="struct.html#__svg__SVGSVGElement__currentTranslate">currentTranslate</a>;

  unsigned long <a href="struct.html#__svg__SVGSVGElement__suspendRedraw">suspendRedraw</a>(in unsigned long maxWaitMilliseconds);
  void <a href="struct.html#__svg__SVGSVGElement__unsuspendRedraw">unsuspendRedraw</a>(in unsigned long suspendHandleID);
  void <a href="struct.html#__svg__SVGSVGElement__unsuspendRedrawAll">unsuspendRedrawAll</a>();
  void <a href="struct.html#__svg__SVGSVGElement__forceRedraw">forceRedraw</a>();
  void <a href="struct.html#__svg__SVGSVGElement__pauseAnimations">pauseAnimations</a>();
  void <a href="struct.html#__svg__SVGSVGElement__unpauseAnimations">unpauseAnimations</a>();
  boolean <a href="struct.html#__svg__SVGSVGElement__animationsPaused">animationsPaused</a>();
  float <a href="struct.html#__svg__SVGSVGElement__getCurrentTime">getCurrentTime</a>();
  void <a href="struct.html#__svg__SVGSVGElement__setCurrentTime">setCurrentTime</a>(in float seconds);
  <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a> <a href="struct.html#__svg__SVGSVGElement__getIntersectionList">getIntersectionList</a>(in <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> rect, in <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> referenceElement);
  <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a> <a href="struct.html#__svg__SVGSVGElement__getEnclosureList">getEnclosureList</a>(in <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> rect, in <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> referenceElement);
  boolean <a href="struct.html#__svg__SVGSVGElement__checkIntersection">checkIntersection</a>(in <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> element, in <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> rect);
  boolean <a href="struct.html#__svg__SVGSVGElement__checkEnclosure">checkEnclosure</a>(in <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> element, in <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> rect);
  void <a href="struct.html#__svg__SVGSVGElement__deselectAll">deselectAll</a>();
  <a class="idlinterface" href="types.html#InterfaceSVGNumber">SVGNumber</a> <a href="struct.html#__svg__SVGSVGElement__createSVGNumber">createSVGNumber</a>();
  <a class="idlinterface" href="types.html#InterfaceSVGLength">SVGLength</a> <a href="struct.html#__svg__SVGSVGElement__createSVGLength">createSVGLength</a>();
  <a class="idlinterface" href="types.html#InterfaceSVGAngle">SVGAngle</a> <a href="struct.html#__svg__SVGSVGElement__createSVGAngle">createSVGAngle</a>();
  <a class="idlinterface" href="coords.html#InterfaceSVGPoint">SVGPoint</a> <a href="struct.html#__svg__SVGSVGElement__createSVGPoint">createSVGPoint</a>();
  <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> <a href="struct.html#__svg__SVGSVGElement__createSVGMatrix">createSVGMatrix</a>();
  <a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a> <a href="struct.html#__svg__SVGSVGElement__createSVGRect">createSVGRect</a>();
  <a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a> <a href="struct.html#__svg__SVGSVGElement__createSVGTransform">createSVGTransform</a>();
  <a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a> <a href="struct.html#__svg__SVGSVGElement__createSVGTransformFromMatrix">createSVGTransformFromMatrix</a>(in <a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a> matrix);
  <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-745549614">Element</a> <a href="struct.html#__svg__SVGSVGElement__getElementById">getElementById</a>(in DOMString elementId);
};</pre><dl class="interface"><dt>属性</dt><dd><dl class="attributes">
<dt id="__svg__SVGSVGElement__x"><b>x</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="struct.html#SVGElementXAttribute"><span class="attr-name">x</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘x’ on the given ‘svg’ element.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__y"><b>y</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="struct.html#SVGElementYAttribute"><span class="attr-name">y</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘y’ on the given ‘svg’ element.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__width"><b>width</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="struct.html#SVGElementWidthAttribute"><span class="attr-name">width</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘width’ on the given ‘svg’ element.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__height"><b>height</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="struct.html#SVGElementHeightAttribute"><span class="attr-name">height</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘height’ on the given ‘svg’ element.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__contentScriptType"><b>contentScriptType</b><span class="idl-type-parenthetical"> (DOMString)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="script.html#ContentScriptTypeAttribute"><span class="attr-name">contentScriptType</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘contentScriptType’ on the given ‘svg’ element.
</span></p>

<dl class="attribute"><dt>設定時の例外</dt><dd><dl class="exceptions"><dt><a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-17189187">DOMException</a>,
code NO_MODIFICATION_ALLOWED_ERR</dt>

<dd class="T">
<a href="svgdom.html#ReadOnlyNodes">読み取り専用の属性</a>
の値の変更を試みたときに投出される。
<span lang="en">
Raised on an attempt to change the value of a read only attribute.
</span>
</dd>
</dl></dd></dl></dd>
<dt id="__svg__SVGSVGElement__contentStyleType"><b>contentStyleType</b><span class="idl-type-parenthetical"> (DOMString)</span></dt><dd>

<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="styling.html#ContentStyleTypeAttribute"><span class="attr-name">contentStyleType</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘contentStyleType’ on the given ‘svg’ element.
</span></p>

<dl class="attribute"><dt>設定時の例外</dt><dd><dl class="exceptions"><dt><a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-17189187">DOMException</a>,
code NO_MODIFICATION_ALLOWED_ERR</dt>

<dd class="T">
<a href="svgdom.html#ReadOnlyNodes">読み取り専用の属性</a>
の値の変更を試みたときに投出される。
<span lang="en">
Raised on an attempt to change the value of a read only attribute.
</span>
</dd>
</dl></dd></dl></dd>
<dt id="__svg__SVGSVGElement__viewport"><b>viewport</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>)</span></dt><dd><div>

<p class="T">
この
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に対応する（暗黙または明示的な）ビューポートの位置と大きさ。
UA が実際に内容を描画しているときは、その実際の位置と大きさを表現する。
位置と大きさは親要素の座標系における単位無しの値を表す。
親要素が存在しない場合（すなわち
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素が文書木のルート）、この SVG 文書が他の文書の一部として埋め込まれているならば（例えば HTML の
<span class="element-name">object</span>
要素により），親の文書の座標系における単位無しの値を表す（もし親が CSS または XSL によるレイアウトを利用している場合、単位無しの値は CSS2 仕様で述べられるように，現在の CSS または XSL ビューポートの画素単位による値を表現する）。
親要素が座標系を持たない場合、 UA はこの属性に対し適切な既定値を与えるべきである。
<span lang="en">
The position and size of the viewport (implicit or explicit) that corresponds to this ‘svg’ element. When the user agent is actually rendering the content, then the position and size values represent the actual values when rendering. The position and size values are unitless values in the coordinate system of the parent element. If no parent element exists (i.e., ‘svg’ element represents the root of the document tree), if this SVG document is embedded as part of another document (e.g., via the HTML ‘object’ element), then the position and size are unitless values in the coordinate system of the parent document. (If the parent uses CSS or XSL layout, then unitless values represent pixel units for the current CSS or XSL viewport, as described in the CSS2 specification.) If the parent element does not have a coordinate system, then the user agent should provide reasonable default values for this attribute.
</span></p>

<p class="T">
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
オブジェクト自身とその内容は共に
<a href="types.html#ReadOnlyRect">読み取り専用</a>
である。
<span lang="en">
The SVGRect object is read only.
</span></p>

</div></dd>
<dt id="__svg__SVGSVGElement__pixelUnitToMillimeterX"><b>pixelUnitToMillimeterX</b><span class="idl-type-parenthetical"> (readonly float)</span></dt><dd>

<p class="T">
ビューポートの X 軸方向の（ CSS2 で定義されているものと同様な）画素単位による長さ。
70dpi から 120dpi までの範囲のどこかを表現し、システムがサポートしていれば対象メディアの特性に合致させられ得る。
システムが画素の大きさを知り得ない場合は、適切な画素の大きさが既定値として与えられる。
<span lang="en">
Size of a pixel units (as defined by CSS2) along the x-axis of the viewport, which represents a unit somewhere in the range of 70dpi to 120dpi, and, on systems that support this, might actually match the characteristics of the target medium. On systems where it is impossible to know the size of a pixel, a suitable default pixel size is provided.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__pixelUnitToMillimeterY"><b>pixelUnitToMillimeterY</b><span class="idl-type-parenthetical"> (readonly float)</span></dt><dd>

<p class="T">
前記に相応するビューポートの Y 軸方向の画素単位による長さ。
<span lang="en">
Corresponding size of a pixel unit along the y-axis of the viewport.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__screenPixelToMillimeterX"><b>screenPixelToMillimeterX</b><span class="idl-type-parenthetical"> (readonly float)</span></dt><dd>

<p class="T">
ビューポートのスクリーン単位による X 軸方向の長さ。
DOM レベル２の UI イベントは与えられた UI イベントが生じたときのスクリーンにおける位置を指示する。
UA が実際に「スクリーン単位」の物理的な長さを知ることができれば、この属性はその情報を表す。
できない場合、 UA は 0.28mm などの適当な既定値を与える。
<span lang="en">
User interface (UI) events in DOM Level 2 indicate the screen positions at which the given UI event occurred. When the user agent actually knows the physical size of a "screen unit", this attribute will express that information; otherwise, user agents will provide a suitable default value such as .28mm.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__screenPixelToMillimeterY"><b>screenPixelToMillimeterY</b><span class="idl-type-parenthetical"> (readonly float)</span></dt><dd>

<p class="T">
前項に相応する，ビューポートのスクリーン単位による Y 軸方向の長さ。
<span lang="en">
Corresponding size of a screen pixel along the y-axis of the viewport.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__useCurrentView"><b>useCurrentView</b><span class="idl-type-parenthetical"> (readonly boolean)</span></dt><dd>

<p class="T">
現在の最も内側の SVG 文書片の初期表示（すなわちズームとパンがなされる前の表示）は、「標準」表示（すなわち
<a href="coords.html#ViewBoxAttribute"><span class="attr-name">viewBox</span></a>
などの
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の属性に基づく表示）または「カスタム」表示（すなわち特定の
<a href="linking.html#ViewElement"><span class="element-name">view</span></a>
または他の要素へのハイパーリンクによる表示 — 
<a href="linking.html#LinksIntoSVG">SVG 内容の中へのリンク： URI 片と SVG ビュー</a>
を見よ）のいずれも有り得る。
初期表示が「標準」表示の場合、この属性は偽になる。
初期表示が「カスタム」表示の場合、この属性は真になる。
<span lang="en">
The initial view (i.e., before magnification and panning) of the current innermost SVG document fragment can be either the "standard" view (i.e., based on attributes on the ‘svg’ element such as ‘viewBox’) or to a "custom" view (i.e., a hyperlink into a particular ‘view’ or other element - see Linking into SVG content: IRI fragments and SVG views). If the initial view is the "standard" view, then this attribute is false. If the initial view is a "custom" view, then this attribute is true.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__currentView"><b>currentView</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGViewSpec">SVGViewSpec</a>)</span></dt><dd><div>

<p class="T">
現在の最も内側の SVG 文書片の初期表示（すなわちズームとパンがなされる前の）の定義。
その意味は状況に依存する：
<span lang="en">
The definition of the initial view (i.e., before magnification and panning) of the current innermost SVG document fragment. The meaning depends on the situation:
</span></p>

 <ul>
   <li>

<p class="T">
初期表示が「標準」表示であった場合：
<span lang="en">
If the initial view was a "standard" view, then:
</span></p>

     <ul>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__viewBox">viewBox</a>,
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__preserveAspectRatio">preserveAspectRatio</a>,
<a class="idlattr" href="types.html#__svg__SVGZoomAndPan__zoomAndPan">zoomAndPan</a>
の値は SVGSVGElement の対応する DOM 属性の値と直接的に一致する。
<span lang="en">
the values for viewBox, preserveAspectRatio and zoomAndPan within currentView will match the values for the corresponding DOM attributes that are on SVGSVGElement directly
</span></li>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGViewSpec__transform">transform</a>
と
<a class="idlattr" href="types.html#__svg__SVGViewSpec__viewTarget">viewTarget</a>
の値は null になる。
<span lang="en">
the values for transform and viewTarget within currentView will be null
</span></li>

     </ul>
   </li>
   <li>

<p class="T">
初期表示が
<a href="linking.html#ViewElement"><span class="element-name">view</span></a>
要素へのリンクによるものであった場合：
<span lang="en">
If the initial view was a link into a ‘view’ element, then:
</span></p>

     <ul>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__viewBox">viewBox</a>,
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__preserveAspectRatio">preserveAspectRatio</a>,
<a class="idlattr" href="types.html#__svg__SVGZoomAndPan__zoomAndPan">zoomAndPan</a>
の値はその
<a href="linking.html#ViewElement"><span class="element-name">view</span></a>
要素の対応する属性に対応する。
<span lang="en">
the values for viewBox, preserveAspectRatio and zoomAndPan within currentView will correspond to the corresponding attributes for the given ‘view’ element
</span></li>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGViewSpec__transform">transform</a>
と
<a class="idlattr" href="types.html#__svg__SVGViewSpec__viewTarget">viewTarget</a>
の値は null にされる。
<span lang="en">
the values for transform and viewTarget within currentView will be null
</span></li>

     </ul>
   </li>
   <li>

<p class="T">
初期表示が他の（すなわち
<span class="element-name">view</span>
以外の）要素へのリンクによるものであった場合：
<span lang="en">
If the initial view was a link into another element (i.e., other than a ‘view’), then:
</span></p>

     <ul>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__viewBox">viewBox</a>,
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__preserveAspectRatio">preserveAspectRatio</a>,
<a class="idlattr" href="types.html#__svg__SVGZoomAndPan__zoomAndPan">zoomAndPan</a>
の値は最も近い先祖の
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に対応する SVGSVGElement の対応する DOM 属性の値と直接的に一致する。
<span lang="en">
the values for viewBox, preserveAspectRatio and zoomAndPan within currentView will match the values for the corresponding DOM attributes that are on SVGSVGElement directly for the closest ancestor ‘svg’ element
</span></li>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGViewSpec__transform">transform</a>
の値は null にされる。
<span lang="en">
the values for transform within currentView will be null
</span></li>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGViewSpec__viewTarget">viewTarget</a>
の値はリンク先を表す。
<span lang="en">
the viewTarget within currentView will represent the target of the link
</span></li>

     </ul>
   </li>
   <li>

<p class="T">
初期表示が SVG ビュー指定片識別子（すなわち #svgView(...)）を用いた SVG 文書片へのリンクによるものであった場合：
<span lang="en">
If the initial view was a link into the SVG document fragment using an SVG view specification fragment identifier (i.e., #svgView(...)), then:
</span></p>

     <ul>

<li class="T">
<a class="idlattr" href="#__svg__SVGSVGElement__currentView">currentView</a>
内の
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__viewBox">viewBox</a>,
<a class="idlattr" href="types.html#__svg__SVGFitToViewBox__preserveAspectRatio">preserveAspectRatio</a>,
<a class="idlattr" href="types.html#__svg__SVGZoomAndPan__zoomAndPan">zoomAndPan</a>,
<a class="idlattr" href="types.html#__svg__SVGViewSpec__transform">transform</a>,
<a class="idlattr" href="types.html#__svg__SVGViewSpec__viewTarget">viewTarget</a>
の値は SVG ビュー指定片識別子による値に対応する。
<span lang="en">
the values for viewBox, preserveAspectRatio, zoomAndPan, transform and viewTarget within currentView will correspond to the values from the SVG view specification fragment identifier
</span></li>

     </ul>
   </li>
 </ul>

<p class="T">
オブジェクト自身とその内容はいずれも読み取り専用である。
<span lang="en">
The object itself and its contents are both read only.
</span></p>

</div></dd>
<dt id="__svg__SVGSVGElement__currentScale"><b>currentScale</b><span class="idl-type-parenthetical"> (float)</span></dt><dd><div>

<p class="T">
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
において、この属性は，利用者による
<a href="interact.html#EnableZoomAndPanControls">ズームとパン</a>
も含めた，初期表示からの現在の表示倍率を表す。
DOM 属性
<a class="idlattr" href="#__svg__SVGSVGElement__currentScale">currentScale</a>,
<a class="idlattr" href="#__svg__SVGSVGElement__currentTranslate">currentTranslate</a>
は、 2x3 行列
[a&nbsp;b&nbsp;c&nbsp;d&nbsp;e&nbsp;f] =
[currentScale&nbsp;0&nbsp;0&nbsp;currentScale&nbsp;currentTranslate.x&nbsp;currentTranslate.y]
に等価である。
つまり，ズームとパンが可用にされている場合（すなわち，
<span class="attr-value">zoomAndPan="magnify"</span>
）、追加の変換が SVG 文書片の最も外側のレベル（すなわち
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
の外側）に置かれたように働く。
<span lang="en">
On an outermost svg element, this attribute indicates the current scale factor relative to the initial view to take into account user magnification and panning operations, as described under Magnification and panning. DOM attributes currentScale and currentTranslate are equivalent to the 2x3 matrix [a&nbsp;b&nbsp;c&nbsp;d&nbsp;e&nbsp;f] = [currentScale&nbsp;0&nbsp;0&nbsp;currentScale&nbsp;currentTranslate.x&nbsp;currentTranslate.y]. If "magnification" is enabled (i.e., zoomAndPan="magnify"), then the effect is as if an extra transformation were placed at the outermost level on the SVG document fragment (i.e., outside the outermost svg element).
</span></p>


<p class="T">
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素が
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
でない場合の，この属性のふるまいは、未定義である。
<span lang="en">
When accessed on an ‘svg’ element that is not an outermost svg element, it is undefined what behavior this attribute has.
</span></p>

</div></dd>
<dt id="__svg__SVGSVGElement__currentTranslate"><b>currentTranslate</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="coords.html#InterfaceSVGPoint">SVGPoint</a>)</span></dt><dd><div>

<p class="T">
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
においては、前記に相応する利用者によるズームとパン操作を計算に入れた並進量。
<span lang="en">
On an outermost svg element, the corresponding translation factor that takes into account user "magnification".
</span></p>


<p class="T">
<a href="intro.html#TermOutermostSVGElement"><span class="svg-term">最も外側の svg 要素</span></a>
でない
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素においては、この属性のふるまいは未定義である。
<span lang="en">
When accessed on an ‘svg’ element that is not an outermost svg element, it is undefined what behavior this attribute has.
</span></p>

</div></dd></dl></dd><dt>演算</dt><dd><dl class="attributes">
<dt id="__svg__SVGSVGElement__suspendRedraw">unsigned long <b>suspendRedraw</b>(in unsigned long <var>maxWaitMilliseconds</var>)</dt><dd><div>

<p class="T">
休止時間をパラメタにとり、次のいずれかの時点まで再描画を休止させることを指示する：
<span lang="en">
Takes a time-out value which indicates that redraw shall not occur until:
</span></p>


 <ol>

<li class="T">
対応する unsuspendRedraw() 呼び出しが行われた時。
<span lang="en">
the corresponding unsuspendRedraw() call has been made,
</span></li>

<li class="T">
unsuspendRedrawAll() 呼び出しが行われたか、または
<span lang="en">
an unsuspendRedrawAll() call has been made, or
</span></li>

<li class="T">
休止時間が経過した時。
<span lang="en">
its timer has timed out.
</span></li>

 </ol>

<p class="T">
対話性がサポートされない環境（例えば印刷メディア）においては、再描画は休止されないものとする。
suspendRedraw() と unsuspendRedraw() の呼び出しは対にすべきであるが、必須ではない。
<span lang="en">
In environments that do not support interactivity (e.g., print media), then redraw shall not be suspended. Calls to suspendRedraw() and unsuspendRedraw() should, but need not be, made in balanced pairs.
</span></p>

<p class="T">
一連の SVG DOM における変化がもたらす再描画を休止させたい場合は、 SVG DOM に対する変更の前に：
<span lang="en">
To suspend redraw actions as a collection of SVG DOM changes occur, precede the changes to the SVG DOM with a method call similar to:
</span></p>

 <pre>suspendHandleID = suspendRedraw(maxWaitMilliseconds);</pre>

<p class="T">
の様にメソッドを呼び出し，変更後に次の様にメソッドを呼び出す：
<span lang="en">
and follow the changes with a method call similar to:
</span></p>

 <pre>unsuspendRedraw(suspendHandleID);</pre>

<p class="T">
suspendRedraw を複数回同時に呼び出した場合の各呼び出しは、それぞれ，他から独立に扱われることに注意。
<span lang="en">
Note that multiple suspendRedraw calls can be used at once and that each such method call is treated independently of the other suspendRedraw method calls.
</span></p>


</div><dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter">unsigned long <var>maxWaitMilliseconds</var></div>

<p class="T">
装置への再描画を休止する時間の長さをミリ秒で指定する。
60 秒以上の値は 60 秒に抑えられる。
<span lang="en">
The amount of time in milliseconds to hold off before redrawing the device. Values greater than 60 seconds will be truncated down to 60 seconds.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
呼び出しに対する一意的な識別子として働く数。
対応する suspendRedraw() の呼び出しには、この値が渡されなければならない。
<span lang="en">
A number which acts as a unique identifier for the given suspendRedraw() call. This value must be passed as the parameter to the corresponding unsuspendRedraw() method call.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__unsuspendRedraw">void <b>unsuspendRedraw</b>(in unsigned long <var>suspendHandleID</var>)</dt><dd>

<p class="T">
以前の suspendRedraw() 呼び出しから得られた識別子に対応する suspendRedraw() を取り消す。
<span lang="en">
Cancels a specified suspendRedraw() by providing a unique suspend handle ID that was returned by a previous suspendRedraw() call.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter">unsigned long <var>suspendHandleID</var></div>

<p class="T">
取り消したい suspendRedraw() 呼び出しに対応する一意的な識別子。
この値は前の suspendRedraw() 呼び出しの返り値でなければならない。
無効な識別子が渡された場合、 unsuspendRedraw() は黙って無視される。
<span lang="en">
A number which acts as a unique identifier for the desired suspendRedraw() call. The number supplied must be a value returned from a previous call to suspendRedraw(). If an invalid handle ID value is provided then the request to unsuspendRedraw() is silently ignored.
</span></p>

</li></ol></dd></dl></dd>
<dt id="__svg__SVGSVGElement__unsuspendRedrawAll">void <b>unsuspendRedrawAll</b>()</dt><dd>

<p class="T">
現在有効な suspendRedraw() メソッド呼び出しすべてを取り消す。
このメソッドは、一連の SVG DOM 呼び出しの最終段階で，すべての suspendRedraw() メソッド呼び出しを清算するときに最も有用である。
<span lang="en">
Cancels all currently active suspendRedraw() method calls. This method is most useful at the very end of a set of SVG DOM calls to ensure that all pending suspendRedraw() method calls have been cancelled.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__forceRedraw">void <b>forceRedraw</b>()</dt><dd>

<p class="T">
対話性をサポートする描画環境において、ビューポートにおいて更新が必要なすべての領域の再描画を直ちに行うことを UA に強制する。
<span lang="en">
In rendering environments supporting interactivity, forces the user agent to immediately redraw all regions of the viewport that require updating.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__pauseAnimations">void <b>pauseAnimations</b>()</dt><dd>

<p class="T">
この
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に対応する SVG 文書片内で定義されている，すべての活動中のアニメーションを休止させる。
この文書片におけるアニメーションの計時は、休止状態が解除されるまで一時停止する。
<span lang="en">
Suspends (i.e., pauses) all currently running animations that are defined within the SVG document fragment corresponding to this ‘svg’ element, causing the animation clock corresponding to this document fragment to stand still until it is unpaused.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__unpauseAnimations">void <b>unpauseAnimations</b>()</dt><dd>

<p class="T">
この
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素に対応する SVG 文書片内で定義されている，すべての休止中のアニメーションを再開させる。
この文書片におけるアニメーションの計時は、一時停止の時点から再開される。
<span lang="en">
Unsuspends (i.e., unpauses) currently running animations that are defined within the SVG document fragment, causing the animation clock to continue from the time at which it was suspended.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__animationsPaused">boolean <b>animationsPaused</b>()</dt><dd>

<p class="T">
この SVG 文書片が休止状態の間、真を返す。
<span lang="en">
Returns true if this SVG document fragment is in a paused state.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
この SVG 文書片が休止状態かどうかを表す真偽値。
<span lang="en">
Boolean indicating whether this SVG document fragment is in a paused state.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__getCurrentTime">float <b>getCurrentTime</b>()</dt><dd>

<p class="T">
現在の SVG 文書片の始動時刻から経過した現在の時刻を秒で返す。
文書時間軸が開始される前に <span class="dom-method-name">getCurrentTime</span> が呼び出された場合（例えば文書の
<a href="interact.html#LoadEvent">SVGLoad</a>
イベントが配送される前の
<a href="script.html#ScriptElement"><span class="element-name">script</span></a>
要素内のスクリプトからの呼び出し）、 0 が返される。
<span lang="en">
Returns the current time in seconds relative to the start time for the current SVG document fragment. If getCurrentTime is called before the document timeline has begun (for example, by script running in a ‘script’ element before the document's SVGLoad event is dispatched), then 0 is returned.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
秒単位による現在の時刻。
文書の時間軸が開始されていなければ 0 。
<span lang="en">
The current time in seconds, or 0 if the document timeline has not yet begun.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__setCurrentTime">void <b>setCurrentTime</b>(in float <var>seconds</var>)</dt><dd>

<p class="T">
この SVG 文書片の計時を調整して、新しく現在の時刻を設定する。
文書時間軸が開始される前に <span class="dom-method-name">setCurrentTime</span> が呼び出された場合（例えば文書の
<a href="interact.html#LoadEvent">SVGLoad</a>
イベントが配送される前の
<a href="script.html#ScriptElement"><span class="element-name">script</span></a>
要素内のスクリプトから呼び出された場合）、文書時間軸の開始の際には，メソッドの最後の呼び出しで与えた <var>seconds</var> による時刻へ飛ぶことになる。
<span lang="en">
Adjusts the clock for this SVG document fragment, establishing a new current time. If setCurrentTime is called before the document timeline has begun (for example, by script running in a ‘script’ element before the document's SVGLoad event is dispatched), then the value of seconds in the last invocation of the method gives the time that the document will seek to once the document timeline has begun.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter">float <var>seconds</var></div>

<p class="T">
新しく設定する現在の時刻を現在の SVG 文書片の始動時刻からの秒数で与える。
<span lang="en">
The new current time in seconds relative to the start time for the current SVG document fragment.
</span></p>

</li></ol></dd></dl></dd>
<dt id="__svg__SVGSVGElement__getIntersectionList"><a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a>
<b>getIntersectionList</b>(in
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var>, in
<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>referenceElement</var>)</dt><dd>

<p class="T">
引数に与えられた矩形と描画域とが交わるグラフィックス要素のリストを返す。
ただし条件に適うものは、
<a href="interact.html#PointerEventsProperty"><span class="prop-name">pointer-events</span></a>
処理で定められる，ポインタイベントの標的になれるグラフィックス要素のみとする。
<span lang="en">
Returns the list of graphics elements whose rendered content intersects the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in ‘pointer-events’ processing.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var></div>

<p class="T">
テストする矩形。
値は現在の
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="coords.html#InitialCoordinateSystem"><span class="svg-term">初期座標系</span></a>
におけるもの。
<span lang="en">
The test rectangle. The values are in the initial coordinate system for the current ‘svg’ element.
</span></p>

</li><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>referenceElement</var></div>

<p class="T">
null でないならば、交わる要素のうち referenceElement を先祖に持たないものは，返される NodeList から除外されなければならない。
<span lang="en">
If not null, then any intersected element that doesn't have the referenceElement as ancestor must not be included in the returned NodeList.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
描画内容が与えられた矩形と交わる要素のリスト。
この
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a>
は、インタフェースが
<a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#td-live">live</a>
でないことを除き，
([<a href="refs.html#ref-DOM2">DOM2</a>], 1.2 節) 
で定められた
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a>
インタフェースと同じになるように実装されなければならない。
<span lang="en">
A list of Elements whose content intersects the supplied rectangle. This NodeList must be implemented identically to the NodeList interface as defined in DOM Level 2 Core ([DOM2], section 1.2) with the exception that the interface is not live.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__getEnclosureList"><a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a>
<b>getEnclosureList</b>(in
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var>, in
<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>referenceElement</var>)</dt><dd>

<p class="T">
描画内容全体が引数に与えられた矩形に囲まれるグラフィックス要素のリストを返す。
ただし条件に適うものは、
<a href="interact.html#PointerEventsProperty"><span class="prop-name">pointer-events</span></a>
処理で定められる，ポインタイベントの標的になれるグラフィックス要素のみとする。
<span lang="en">
Returns the list of graphics elements whose rendered content is entirely contained within the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in ‘pointer-events’ processing.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var></div>

<p class="T">
テストする矩形。
値は現在の
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="coords.html#InitialCoordinateSystem"><span class="svg-term">初期座標系</span></a>
におけるもの。
<span lang="en">
The test rectangle. The values are in the initial coordinate system for the current ‘svg’ element.
</span></p>

</li><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>referenceElement</var></div>

<p class="T">
null でないならば、囲まれる要素のうち referenceElement を先祖に持たないものは，返される NodeList から除外されなければならない。
<span lang="en">
If not null, then any intersected<!-- entirely contained --> element that doesn't have the referenceElement as ancestor must not be included in the returned NodeList. 
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
描画内容全体が引数に与えられた矩形に囲まれる要素のリスト。
この
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a>
は、インタフェースが
<a href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#td-live">live</a>
でないことを除き，
([<a href="refs.html#ref-DOM2">DOM2</a>], 1.2 節) 
で定められた
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-536297177">NodeList</a>
インタフェースと同じになるように実装されなければならない。
<span lang="en">
A list of Elements whose content is enclosed by the supplied rectangle. This NodeList must be implemented identically to the NodeList interface as defined in DOM Level 2 Core ([DOM2], section 1.2) with the exception that the interface is not live.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__checkIntersection">boolean <b>checkIntersection</b>(in
<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>element</var>, in
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var>)</dt><dd>

<p class="T">
<!--  -->
引数に与えられた要素の描画内容が引数に与えられた矩形と交わるとき、真を返す。
ただし条件に適うものは、
<a href="interact.html#PointerEventsProperty"><span class="prop-name">pointer-events</span></a>
処理で定められる，ポインタイベントの標的になれるグラフィックス要素のみとする。
<span lang="en">
Returns true if the rendered content of the given element intersects the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in ‘pointer-events’ processing.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>element</var></div>

<p class="T">
テストする要素。
<span lang="en">
The element on which to perform the given test.
</span></p>

</li><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var></div>

<p class="T">
テストする矩形。
値は現在の
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="coords.html#InitialCoordinateSystem"><span class="svg-term">初期座標系</span></a>
におけるもの。
<span lang="en">
The test rectangle. The values are in the initial coordinate system for the current ‘svg’ element.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
与えられた要素が与えられた矩形と交わるかどうかを表す真偽値。
<span lang="en">
True or false, depending on whether the given element intersects the supplied rectangle.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__checkEnclosure">boolean <b>checkEnclosure</b>(in
<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>element</var>, in
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var>)</dt><dd>

<p class="T">
引数に与えられた要素の描画内容全体が引数に与えられた矩形に囲まれるとき、真を返す。
ただし条件に適うものは、
<a href="interact.html#PointerEventsProperty"><span class="prop-name">pointer-events</span></a>
処理で定められる，ポインタイベントの標的になれるグラフィックス要素のみとする。
<span lang="en">
Returns true if the rendered content of the given element is entirely contained within the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in ‘pointer-events’ processing.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>
<var>element</var></div>

<p class="T">
テストする要素。
<span lang="en">
The element on which to perform the given test.
</span></p>

</li><li><div class="parameter"><a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<var>rect</var></div>

<p class="T">
テストする矩形。
値は現在の
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素の
<a href="coords.html#InitialCoordinateSystem"><span class="svg-term">初期座標系</span></a>
におけるもの。
<span lang="en">
The test rectangle. The values are in the initial coordinate system for the current ‘svg’ element.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
与えられた要素が与えられた矩形に囲まれるかどうかを表す真偽値。
<span lang="en">
True or false, depending on whether the given element is enclosed by the supplied rectangle.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__deselectAll">void <b>deselectAll</b>()</dt><dd>

<p class="T">
テキスト文字列や文字入力域の選択も含め、選択されているオブジェクトの選択を解除する。
<span lang="en">
Unselects any selected objects, including any selections of text strings and type-in bars.
</span></p>

</dd>
<dt id="__svg__SVGSVGElement__createSVGNumber"><a class="idlinterface" href="types.html#InterfaceSVGNumber">SVGNumber</a>
<b>createSVGNumber</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="types.html#InterfaceSVGNumber">SVGNumber</a>
オブジェクトを作成する。
オブジェクトは値 0 に初期化される。
<span lang="en">
Creates an SVGNumber object outside of any document trees. The object is initialized to a value of zero.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="types.html#InterfaceSVGNumber">SVGNumber</a>
オブジェクト。
<span lang="en">
An SVGNumber object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGLength"><a class="idlinterface" href="types.html#InterfaceSVGLength">SVGLength</a>
<b>createSVGLength</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="types.html#InterfaceSVGLength">SVGLength</a>
オブジェクトを作成する。
オブジェクトは値 0 利用単位に初期化される。
<span lang="en">
Creates an SVGLength object outside of any document trees. The object is initialized to the value of 0 user units.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="types.html#InterfaceSVGLength">SVGLength</a>
オブジェクト。
<span lang="en">
An SVGLength object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGAngle"><a class="idlinterface" href="types.html#InterfaceSVGAngle">SVGAngle</a>
<b>createSVGAngle</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="types.html#InterfaceSVGAngle">SVGAngle</a>
オブジェクトを作成する。
オブジェクトは値 0 に初期化される（単位なし）。
<span lang="en">
Creates an SVGAngle object outside of any document trees. The object is initialized to the value 0 degrees (unitless).
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="types.html#InterfaceSVGAngle">SVGAngle</a>
オブジェクト。
<span lang="en">
An SVGAngle object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGPoint"><a class="idlinterface" href="coords.html#InterfaceSVGPoint">SVGPoint</a>
<b>createSVGPoint</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="coords.html#InterfaceSVGPoint">SVGPoint</a>
オブジェクトを作成する。
オブジェクトは利用座標系の点 (0, 0) に初期化される。
<span lang="en">
Creates an SVGPoint object outside of any document trees. The object is initialized to the point (0,0) in the user coordinate system.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="coords.html#InterfaceSVGPoint">SVGPoint</a>
オブジェクト。
<span lang="en">
An SVGPoint object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGMatrix"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>
<b>createSVGMatrix</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>
オブジェクトを作成する。
オブジェクトは単位行列に初期化される。
<span lang="en">
Creates an SVGMatrix object outside of any document trees. The object is initialized to the identity matrix.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>
オブジェクト。
<span lang="en">
An SVGMatrix object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGRect"><a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
<b>createSVGRect</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
オブジェクトを作成する。
オブジェクトはすべての値が 0 利用単位に初期化される。
<span lang="en">
Creates an SVGRect object outside of any document trees. The object is initialized such that all values are set to 0 user units.
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="types.html#InterfaceSVGRect">SVGRect</a>
オブジェクト。
<span lang="en">
An SVGRect object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGTransform"><a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a>
<b>createSVGTransform</b>()</dt><dd>

<p class="T">
文書木の外に
<a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a>
オブジェクトを作成する。
オブジェクトは単位行列による変換（ SVG_TRANSFORM_MATRIX ）に初期化される。
<span lang="en">
Creates an SVGTransform object outside of any document trees. The object is initialized to an identity matrix transform (SVG_TRANSFORM_MATRIX).
</span></p>

<dl class="operation"><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a>
オブジェクト。
<span lang="en">
An SVGTransform object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__createSVGTransformFromMatrix"><a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a>
<b>createSVGTransformFromMatrix</b>(in
<a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>
<var>matrix</var>)</dt><dd><div>

<p class="T">
文書木の外に
<a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a>
オブジェクトを作成する。
オブジェクトは与えられた行列による変換（すなわち SVG_TRANSFORM_MATRIX ）に初期化される。
パラメタ <var>matrix</var> からの値は複製され、 <var>matrix</var> がそのまま
<a class="idlattr" href="coords.html#__svg__SVGTransform__matrix">SVGTransform::matrix</a>
になることはない。
<span lang="en">
Creates an SVGTransform object outside of any document trees. The object is initialized to the given matrix transform (i.e., SVG_TRANSFORM_MATRIX). The values from the parameter matrix are copied, the matrix parameter is not adopted as SVGTransform::matrix.
</span></p>


</div><dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter"><a class="idlinterface" href="coords.html#InterfaceSVGMatrix">SVGMatrix</a>
<var>matrix</var></div>

<p class="T">
変換行列。
<span lang="en">
The transform matrix.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="coords.html#InterfaceSVGTransform">SVGTransform</a>
オブジェクト。
<span lang="en">
An SVGTransform object.
</span></p>

</dd></dl></dd>
<dt id="__svg__SVGSVGElement__getElementById"><a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-745549614">Element</a>
<b>getElementById</b>(in DOMString <var>elementId</var>)</dt><dd>

<p class="T">
与えられた <var>elementId</var> を id に持つ Element オブジェクトをこの SVG 文書片から検索する（すなわち検索範囲は文書木の一部分に限定される）。
Element が見つかった場合はそれが返され、見つからなかった場合は
<span class="DOMValue">null</span>
が返される。
複数の要素がこの id を持つ場合のふるまいは未定義である。
<span lang="en">
Searches this SVG document fragment (i.e., the search is restricted to a subset of the document tree) for an Element whose id is given by elementId. If an Element is found, that Element is returned. If no such element exists, returns null. Behavior is not defined if more than one element has this id.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter">DOMString <var>elementId</var></div>

<p class="T">
要素に対し一意的な id 値。
<span lang="en">
The unique id value for an element.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
合致した要素。
<span lang="en">
The matching element.
</span></p>

</dd></dl></dd></dl></dd></dl>


<h3 title="5.11.3 Interface SVGGElement" id="InterfaceSVGGElement">5.11.3 インタフェース SVGGElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGSVGElement">SVGSVGElement</a>
インタフェースは
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素に対応する。
<span lang="en">
The SVGSVGElement interface corresponds to the ‘g’ element.
</span></p>


<pre class="idl">interface <b>SVGGElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                        <a class="idlinterface" href="types.html#InterfaceSVGTests">SVGTests</a>,
                        <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                        <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                        <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                        <a class="idlinterface" href="types.html#InterfaceSVGTransformable">SVGTransformable</a> {
};</pre>


<h3 title="5.11.4 Interface SVGDefsElement" id="InterfaceSVGDefsElement">5.11.4 インタフェース SVGDefsElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGDefsElement">SVGDefsElement</a>
インタフェースは
<a href="struct.html#DefsElement"><span class="element-name">defs</span></a>
要素に対応する。
<span lang="en">
The SVGDefsElement interface corresponds to the ‘defs’ element.
</span></p>


<pre class="idl">interface <b>SVGDefsElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGTests">SVGTests</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGTransformable">SVGTransformable</a> {
};</pre>


<h3 title="5.11.5 Interface SVGDescElement" id="InterfaceSVGDescElement">5.11.5 インタフェース SVGDescElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGDescElement">SVGDescElement</a>
インタフェースは
<a href="struct.html#DescElement"><span class="element-name">desc</span></a>
要素に対応する。
<span lang="en">
The SVGDescElement interface corresponds to the ‘desc’ element.
</span></p>


<pre class="idl">interface <b>SVGDescElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                           <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a> {
};</pre>


<h3 title="5.11.6 Interface SVGTitleElement" id="InterfaceSVGTitleElement">5.11.6 インタフェース SVGTitleElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGTitleElement">SVGTitleElement</a>
インタフェースは
<a href="struct.html#TitleElement"><span class="element-name">title</span></a>
要素に対応する。
<span lang="en">
The SVGTitleElement interface corresponds to the ‘title’ element.
</span></p>


<pre class="idl">interface <b>SVGTitleElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a> {
};</pre>


<h3 title="5.11.7 Interface SVGSymbolElement" id="InterfaceSVGSymbolElement">5.11.7 インタフェース SVGSymbolElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGSymbolElement">SVGSymbolElement</a>
インタフェースは
<a href="struct.html#SymbolElement"><span class="element-name">symbol</span></a>
要素に対応する。
<span lang="en">
The SVGSymbolElement interface corresponds to the ‘symbol’ element.
</span></p>


<pre class="idl">interface <b>SVGSymbolElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGFitToViewBox">SVGFitToViewBox</a> {
};</pre>


<h3 title="5.11.8 Interface SVGUseElement" id="InterfaceSVGUseElement">5.11.8 インタフェース SVGUseElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGUseElement">SVGUseElement</a>
インタフェースは
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に対応する。
<span lang="en">
The SVGUseElement interface corresponds to the ‘use’ element.
</span></p>


<pre class="idl">interface <b>SVGUseElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGURIReference">SVGURIReference</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGTests">SVGTests</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                          <a class="idlinterface" href="types.html#InterfaceSVGTransformable">SVGTransformable</a> {
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGUseElement__x">x</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGUseElement__y">y</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGUseElement__width">width</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGUseElement__height">height</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGUseElement__instanceRoot">instanceRoot</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGUseElement__animatedInstanceRoot">animatedInstanceRoot</a>;
};</pre><dl class="interface"><dt>属性</dt><dd><dl class="attributes">
<dt id="__svg__SVGUseElement__x"><b>x</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementXAttribute"><span class="attr-name">x</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘x’ on the given ‘use’ element.
</span></p>

</dd>
<dt id="__svg__SVGUseElement__y"><b>y</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementYAttribute"><span class="attr-name">y</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘y’ on the given ‘use’ element.
</span></p>

</dd>
<dt id="__svg__SVGUseElement__width"><b>width</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementWidthAttribute"><span class="attr-name">width</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘width’ on the given ‘use’ element.
</span></p>

</dd>
<dt id="__svg__SVGUseElement__height"><b>height</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の
<a href="struct.html#UseElementHeightAttribute"><span class="attr-name">height</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘height’ on the given ‘use’ element.
</span></p>

</dd>
<dt id="__svg__SVGUseElement__instanceRoot"><b>instanceRoot</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
「インスタンス木」のルート。
インスタンス木についての説明は
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の記述を見よ。
<span lang="en">
The root of the "instance tree". See description of SVGElementInstance for a discussion on the instance tree.
</span></p>

</dd>
<dt id="__svg__SVGUseElement__animatedInstanceRoot"><b>animatedInstanceRoot</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
<a href="struct.html#UseElementHrefAttribute"><span class="attr-name">xlink:href</span></a>
属性がアニメートされている場合は現在アニメーション中の「インスタンス木」のルート。
<a href="struct.html#UseElementHrefAttribute"><span class="attr-name">xlink:href</span></a>
属性がアニメートされていない場合は
<a class="idlattr" href="#__svg__SVGUseElement__instanceRoot">instanceRoot</a>
と同じ値をとる。
インスタンス木についての説明は
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の記述を見よ。
<span lang="en">
If the ‘xlink:href’ attribute is being animated, contains the current animated root of the "instance tree". If the ‘xlink:href’ attribute is not currently being animated, contains the same value as instanceRoot. See description of SVGElementInstance for a discussion on the instance tree.
</span></p>

</dd></dl></dd></dl>


<h3 title="5.11.9 Interface SVGElementInstance" id="InterfaceSVGElementInstance">5.11.9 インタフェース SVGElementInstance</h3>

<p class="T">
各
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に対し、 SVG DOM は
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
型のオブジェクトからなる非公開木（「インスタンス木」）を維持管理する。
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
はインスタンス木における１個のノードを表現する。
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に対応する
<a class="idlinterface" href="struct.html#InterfaceSVGUseElement">SVGUseElement</a>
オブジェクトの
<a class="idlattr" href="struct.html#__svg__SVGUseElement__instanceRoot">instanceRoot</a>
属性がインスタンス木のルートオブジェクトを指す。
<span lang="en">
For each ‘use’ element, the SVG DOM maintains a shadow tree (the "instance tree") of objects of type SVGElementInstance. An SVGElementInstance represents a single node in the instance tree. The root object in the instance tree is pointed to by the instanceRoot attribute on the SVGUseElement object for the corresponding ‘use’ element.
</span></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
などの単純なグラフィックス要素を参照する場合、ただ１個の
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトが存在し，この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトの
<a class="idlattr" href="#__svg__SVGElementInstance__correspondingElement">correspondingElement</a>
属性は参照先の
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素に対応する
<a class="idlinterface" href="shapes.html#InterfaceSVGRectElement">SVGRectElement</a>
になる。
<span lang="en">
If the ‘use’ element references a simple graphics element such as a ‘rect’, then there is only a single SVGElementInstance object, and the correspondingElement attribute on this SVGElementInstance object is the SVGRectElement that corresponds to the referenced ‘rect’ element.
</span></p>

<p class="T">
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が２個の
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素を持つ
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素を参照している場合、インスタンス木には３個の
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクト — ルートの
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトでその
<a class="idlattr" href="#__svg__SVGElementInstance__correspondingElement">correspondingElement</a>
が
<a href="struct.html#GElement"><span class="element-name">g</span></a>
に対応する
<a class="idlinterface" href="struct.html#InterfaceSVGGElement">SVGGElement</a>
オブジェクトになるもの, および ２個の
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
子オブジェクトでそれぞれの
<a class="idlattr" href="#__svg__SVGElementInstance__correspondingElement">correspondingElement</a>
が
<a class="idlinterface" href="shapes.html#InterfaceSVGRectElement">SVGRectElement</a>
オブジェクトになるもの — が存在する。
<span lang="en">
If the ‘use’ element references a ‘g’ which contains two ‘rect’ elements, then the instance tree contains three SVGElementInstance objects, a root SVGElementInstance object whose correspondingElement is the SVGGElement object for the ‘g’, and then two child SVGElementInstance objects, each of which has its correspondingElement that is an SVGRectElement object.
</span></p>

<p class="T">
参照先のオブジェクト自身が
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素であるか，あるいは参照先のオブジェクト内に
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
子要素がある場合、インスタンス木は完全な木を形成するために間接参照を通して再帰的に拡張される。
例えば
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="struct.html#GElement"><span class="element-name">g</span></a>
を参照していて,
<a href="struct.html#GElement"><span class="element-name">g</span></a>
要素自身が
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
を含んでいて，その
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
が
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素を参照している場合、最初の（最も外側の）
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
のインスタンス木は次のような
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクト階層で構成される：
<span lang="en">
If the referenced object is itself a ‘use’, or if there are ‘use’ subelements within the referenced object, the instance tree will contain recursive expansion of the indirect references to form a complete tree. For example, if a ‘use’ element references a ‘g’, and the ‘g’ itself contains a ‘use’, and that ‘use’ references a ‘rect’, then the instance tree for the original (outermost) ‘use’ will consist of a hierarchy of SVGElementInstance objects, as follows:
</span></p>


<pre>SVGElementInstance #1 (parentNode=null, firstChild=#2, correspondingElement is the 'g')
  SVGElementInstance #2 (parentNode=#1, firstChild=#3, correspondingElement is the other 'use')
    SVGElementInstance #3 (parentNode=#2, firstChild=null, correspondingElement is the 'rect')
</pre>
<pre class="idl">interface <b>SVGElementInstance</b> : <a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-EventTarget">EventTarget</a> {
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a> <a href="struct.html#__svg__SVGElementInstance__correspondingElement">correspondingElement</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGUseElement">SVGUseElement</a> <a href="struct.html#__svg__SVGElementInstance__correspondingUseElement">correspondingUseElement</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGElementInstance__parentNode">parentNode</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstanceList">SVGElementInstanceList</a> <a href="struct.html#__svg__SVGElementInstance__childNodes">childNodes</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGElementInstance__firstChild">firstChild</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGElementInstance__lastChild">lastChild</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGElementInstance__previousSibling">previousSibling</a>;
  readonly attribute <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGElementInstance__nextSibling">nextSibling</a>;
};</pre><dl class="interface"><dt>属性</dt><dd><dl class="attributes">
<dt id="__svg__SVGElementInstance__correspondingElement"><b>correspondingElement</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>)</span></dt><dd>

<p class="T">
このオブジェクトがそのインスタンスとなる、対応する要素。
例えば
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素を参照しているならば、
<a class="idlattr" href="#__svg__SVGElementInstance__correspondingElement">correspondingElement</a>
が
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素に対応する
<a class="idlinterface" href="shapes.html#InterfaceSVGRectElement">SVGRectElement</a>
オブジェクトになるような
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
が作成される。
<span lang="en">
The corresponding element to which this object is an instance. For example, if a ‘use’ element references a ‘rect’ element, then an SVGElementInstance is created, with its correspondingElement being the SVGRectElement object for the ‘rect’ element.
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__correspondingUseElement"><b>correspondingUseElement</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGUseElement">SVGUseElement</a>)</span></dt><dd>

<p class="T">
この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトが属するインスタンス木に対応する
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素。
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が入れ子になっている場合（例えば
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
が別の
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素を参照していて，その
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素が
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>
要素などのグラフィックス要素を参照している場合）、
<a class="idlattr" href="#__svg__SVGElementInstance__correspondingUseElement">correspondingUseElement</a>
は最も外側の（すなわち、
<a href="shapes.html#RectElement"><span class="element-name">rect</span></a>,
を直接参照する
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素の方ではなく，間接的に参照する方の）
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
になる。
<span lang="en">
The corresponding ‘use’ element to which this SVGElementInstance object belongs. When ‘use’ elements are nested (e.g., a ‘use’ references another ‘use’ which references a graphics element such as a ‘rect’), then the correspondingUseElement is the outermost ‘use’ (i.e., the one which indirectly references the ‘rect’, not the one with the direct reference).
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__parentNode"><b>parentNode</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
インスタンス木における，この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の親。
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトは
<a href="struct.html#UseElement"><span class="element-name">use</span></a>
要素に直接参照されている要素に対応する場合に限り、親を持たず，その場合の
<a class="idlattr" href="#__svg__SVGElementInstance__parentNode">parentNode</a>
は null になる。
<span lang="en">
The parent of this SVGElementInstance within the instance tree. All SVGElementInstance objects have a parent except the SVGElementInstance which corresponds to the element which was directly referenced by the ‘use’ element, in which case parentNode is null.
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__childNodes"><b>childNodes</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstanceList">SVGElementInstanceList</a>)</span></dt><dd>

<p class="T">
インスタンス木における，この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
のすべての子からなる
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstanceList">SVGElementInstanceList</a>
。
子が存在しない場合、項目が空の
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstanceList">SVGElementInstanceList</a>
になる（すなわち、空リスト）。
<span lang="en">
An SVGElementInstanceList that contains all children of this SVGElementInstance within the instance tree. If there are no children, this is an SVGElementInstanceList containing no entries (i.e., an empty list).
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__firstChild"><b>firstChild</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
インスタンス木における，この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の最初の子。
存在しない場合は null を返す。
<span lang="en">
The first child of this SVGElementInstance within the instance tree. If there is no such SVGElementInstance, this returns null.
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__lastChild"><b>lastChild</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
インスタンス木における，この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の最後の子。
存在しない場合は null を返す。
<span lang="en">
The last child of this SVGElementInstance within the instance tree. If there is no such SVGElementInstance, this returns null.
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__previousSibling"><b>previousSibling</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の直前にある
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
。
存在しない場合は null を返す。
<span lang="en">
The SVGElementInstance immediately preceding this SVGElementInstance. If there is no such SVGElementInstance, this returns null.
</span></p>

</dd>
<dt id="__svg__SVGElementInstance__nextSibling"><b>nextSibling</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>)</span></dt><dd>

<p class="T">
この
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
の直後にある
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
。
存在しない場合は null を返す。
<span lang="en">
The SVGElementInstance immediately following this SVGElementInstance. If there is no such SVGElementInstance, this returns null.
</span></p>

</dd></dl></dd></dl>

<h3 title="5.11.10 Interface SVGElementInstanceList" id="InterfaceSVGElementInstanceList">5.11.10 インタフェース SVGElementInstanceList</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstanceList">SVGElementInstanceList</a>
インタフェースは、実装の仕方を定義／制約しない，抽象化された
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトの順序付きのリストを表現する。
<span lang="en">
The SVGElementInstanceList interface provides the abstraction of an ordered collection of SVGElementInstance objects, without defining or constraining how this collection is implemented.
</span></p>


<pre class="idl">interface <b>SVGElementInstanceList</b> {

  readonly attribute unsigned long <a href="struct.html#__svg__SVGElementInstanceList__length">length</a>;

  <a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a> <a href="struct.html#__svg__SVGElementInstanceList__item">item</a>(in unsigned long index);
};</pre><dl class="interface"><dt>属性</dt><dd><dl class="attributes">
<dt id="__svg__SVGElementInstanceList__length"><b>length</b><span class="idl-type-parenthetical"> (readonly unsigned long)</span></dt><dd>

<p class="T">
リストに含まれる
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクトの個数。
ノードのインデックスの範囲は 0 から
<a class="idlattr" href="#__svg__SVGElementInstanceList__length">length</a>-1
まで。
<span lang="en">
The number of SVGElementInstance objects in the list. The range of valid child indices is 0 to length-1 inclusive.
</span></p>

</dd></dl></dd><dt>演算</dt><dd><dl class="attributes">
<dt id="__svg__SVGElementInstanceList__item"><a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
<b>item</b>(in unsigned long <var>index</var>)</dt><dd>

<p class="T">
リストの <var>index</var> 番目のノードを返す。
<var>index</var> がリスト内のノード数以上の場合は null を返す。
<span lang="en">
Returns the indexth item in the collection. If index is greater than or equal to the number of nodes in the list, this returns null.
</span></p>

<dl class="operation"><dt>パラメタ</dt><dd><ol class="parameters"><li><div class="parameter">unsigned long <var>index</var></div>

<p class="T">
リストの項目のインデックス。
<span lang="en">
Index into the collection.
</span></p>

</li></ol></dd><dt>返り値</dt><dd>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstanceList">SVGElementInstanceList</a>
の <var>index</var> 番目の
<a class="idlinterface" href="struct.html#InterfaceSVGElementInstance">SVGElementInstance</a>
オブジェクト。
インデックスが無効な場合は null を返す。
<span lang="en">
The SVGElementInstance object at the indexth position in the SVGElementInstanceList, or null if that is not a valid index.
</span></p>

</dd></dl></dd></dl></dd></dl>

<h3 title="5.11.11 Interface SVGImageElement" id="InterfaceSVGImageElement">5.11.11 インタフェース SVGImageElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGImageElement">SVGImageElement</a>
インタフェースは
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素に対応する。
<span lang="en">
The SVGImageElement interface corresponds to the ‘image’ element.
</span></p>


<pre class="idl">interface <b>SVGImageElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGURIReference">SVGURIReference</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGTests">SVGTests</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                            <a class="idlinterface" href="types.html#InterfaceSVGTransformable">SVGTransformable</a> {
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGImageElement__x">x</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGImageElement__y">y</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGImageElement__width">width</a>;
  readonly attribute <a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a> <a href="struct.html#__svg__SVGImageElement__height">height</a>;
  readonly attribute <a class="idlinterface" href="coords.html#InterfaceSVGAnimatedPreserveAspectRatio">SVGAnimatedPreserveAspectRatio</a> <a href="struct.html#__svg__SVGImageElement__preserveAspectRatio">preserveAspectRatio</a>;
};</pre><dl class="interface"><dt>属性</dt><dd><dl class="attributes">
<dt id="__svg__SVGImageElement__x"><b>x</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="struct.html#ImageElementXAttribute"><span class="attr-name">x</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘x’ on the given ‘image’ element.
</span></p>

</dd>
<dt id="__svg__SVGImageElement__y"><b>y</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="struct.html#ImageElementYAttribute"><span class="attr-name">y</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘y’ on the given ‘image’ element.
</span></p>

</dd>
<dt id="__svg__SVGImageElement__width"><b>width</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="struct.html#ImageElementWidthAttribute"><span class="attr-name">width</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘width’ on the given ‘image’ element.
</span></p>

</dd>
<dt id="__svg__SVGImageElement__height"><b>height</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="types.html#InterfaceSVGAnimatedLength">SVGAnimatedLength</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="struct.html#ImageElementHeightAttribute"><span class="attr-name">height</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘height’ on the given ‘image’ element.
</span></p>

</dd>
<dt id="__svg__SVGImageElement__preserveAspectRatio"><b>preserveAspectRatio</b><span class="idl-type-parenthetical"> (readonly
<a class="idlinterface" href="coords.html#InterfaceSVGAnimatedPreserveAspectRatio">SVGAnimatedPreserveAspectRatio</a>)</span></dt><dd>

<p class="T">
与えられた
<a href="struct.html#ImageElement"><span class="element-name">image</span></a>
要素の
<a href="coords.html#PreserveAspectRatioAttribute"><span class="attr-name">preserveAspectRatio</span></a>
属性に対応する。
<span lang="en">
Corresponds to attribute ‘preserveAspectRatio’ on the given ‘image’ element.
</span></p>

</dd></dl></dd></dl>


<h3 title="5.11.12 Interface SVGSwitchElement" id="InterfaceSVGSwitchElement">5.11.12 インタフェース SVGSwitchElement</h3>

<p class="T">
<a class="idlinterface" href="struct.html#InterfaceSVGSwitchElement">SVGSwitchElement</a>
インタフェースは
<a href="struct.html#SwitchElement"><span class="element-name">switch</span></a>
要素に対応する。
<span lang="en">
The SVGSwitchElement interface corresponds to the ‘switch’ element.
</span></p>


<pre class="idl">interface <b>SVGSwitchElement</b> : <a class="idlinterface" href="types.html#InterfaceSVGElement">SVGElement</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGTests">SVGTests</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGLangSpace">SVGLangSpace</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGExternalResourcesRequired">SVGExternalResourcesRequired</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGStylable">SVGStylable</a>,
                             <a class="idlinterface" href="types.html#InterfaceSVGTransformable">SVGTransformable</a> {
};</pre>


<h3 title="5.11.13 Interface GetSVGDocument" id="InterfaceGetSVGDocument">5.11.13 インタフェース GetSVGDocument</h3>

<p class="T">
このインタフェースは、他の DOM ベースの言語に対し，参照を通して埋め込まれた SVG 文書へのアクセスを提供する。
例外は、 HTML <span class="element-name">object</span> 要素に対応する DOM
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-745549614">Element</a>
オブジェクトなどの様に， DOM オブジェクトにそのような SVG 文書への参照を可能にするインタフェースが実装されている場合である。
大抵の場合、そのような DOM オブジェクトには Window 仕様
[<a href="refs.html#ref-WINDOW">WINDOW</a>]
で定められている
<a class="idlinterface">EmbeddingElement</a><!-- リンク無し -->
の実装も要求されている。
<span lang="en">
This interface provides access to an SVG document embedded by reference in another DOM-based language. The expectation is that the interface is implemented on DOM objects that allow such SVG document references, such as the DOM Element object that corresponds to an HTML ‘object’ element. Such DOM objects are often also required to implement the EmbeddingElement defined in the Window specification [WINDOW].
</span></p>

<p class="T">
このインタフェースは廃止予定にあり、将来版の SVG 仕様からは削除され得る。
文書作成者には、参照先の SVG 文書の取得する際には（もしあれば） 
<a class="idlinterface" href="">EmbeddingElement</a>
インタフェースの <code>contentDocument</code> 属性の利用が奨励される。
<span lang="en">
This interface is deprecated and may be dropped from future versions of the SVG specification. Authors are suggested to use the contentDocument attribute on the EmbeddingElement interface to obtain a referenced SVG document, if that interface is available.
</span></p>

<pre class="idl">interface <b>GetSVGDocument</b> {
  <a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a> <a href="struct.html#__svg__GetSVGDocument__getSVGDocument">getSVGDocument</a>();
};</pre><dl class="interface"><dt>演算</dt><dd><dl class="attributes">
<dt id="__svg__GetSVGDocument__getSVGDocument"><a class="idlinterface" href="struct.html#InterfaceSVGDocument">SVGDocument</a>
<b>getSVGDocument</b>()</dt><dd><div>

<p class="T">
このメソッドは、埋め込んでいる要素における，埋め込み内容の
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#i-Document">Document</a>
オブジェクト，あるいは文書が存在していなければ null を返さなければならない。
<span lang="en">
This method must return the Document object embedded content in an embedding element, or null if there is no document.
</span></p>

<p class="T">
これは埋め込んでいる要素に
<a class="idlinterface" href="">EmbeddingElement</a>
インタフェースも実装されているならば、その要素の <code>EmbeddingElement::contentDocument</code> 属性にアクセスするに等しくなることに注意。
文書作成者には、返された
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#i-Document">Document</a>
が実際に
<a href="struct.html#SVGElement"><span class="element-name">svg</span></a>
要素なのかどうか確かめることを薦める。
<span lang="en">
Note that this is equivalent to fetching the value of the EmbeddingElement::contentDocument attribute of the embedding element, if the EmbeddingElement interface is also implemented. The author is advised to check that the document element of the returned Document is indeed an ‘svg’ element instead of assuming that that will always be the case.
</span></p>


</div><dl class="operation"><dt>返り値</dt><dd>

<p class="T">
参照先の SVG 文書に対する
<a class="idlinterface" href="http://www.w3.org/TR/DOM-Level-2-Core/core.html#i-Document">Document</a>
オブジェクト。
存在しなければ null を返す。
<span lang="en">
The Document object for the referenced document, or null if there is no document.
</span></p>

</dd></dl></dd></dl></dd></dl>

<div class="header bottom">
<a href="index.html#minitoc">目次</a> ⋅
<a href="expanded-toc.html">詳細目次</a> ⋅
<a href="types.html">前章</a> ⋅
<a href="styling.html">次章</a> ⋅
<a href="eltindex.html">要素</a> ⋅
<a href="attindex.html">属性</a> ⋅
<a href="propidx.html">プロパティ</a>
</div><script src="style/expanders.js" type="text/javascript"> </script>

</body>
</html>