14 リンク

目次

• 14.1 参照
  • 14.1.1 概観
  • 14.1.2 IRI と URI
  • 14.1.3 構文形式： IRI と FuncIRI
  • 14.1.4 参照の制約
  • 14.1.5 IRI 参照属性
  • 14.1.6 文書への外部参照の処理
• 14.2 SVG 内容から外へのリンク：'a' 要素
  • 14.2.1 リンクの指示
• 14.3 SVG 内容の中へのリンク：IRI 素片と SVG ビュー
  • 14.3.1 IRI 素片と SVG ビューの概要
  • 14.3.2 SVG 素片識別子

14.1 参照

14.1.1 概観

インターネットにおいては、リソースは IRI （Internationalized Resource Identifiers - 国際化リソース識別子）により識別される。例えば、 http://example.com に置かれた SVG ファイル someDrawing.svg は次の IRI を持つ： On the Internet, resources are identified using IRIs (Internationalized Resource Identifiers). For example, an SVG file called someDrawing.svg located at http://example.com might have the following IRI:

http://example.com/someDrawing.svg

IRI はその一部として IRI 素片識別子を含めることにより、 XML 文書内の特定の要素を指すようにすることもできる。 IRI 素片識別子を含む IRI は、省略可能な基底と IRI 後続する文字 "#" , IRI 素片識別子からなる。例えば次の IRI はファイル someDrawing.svg 内の ID が "Lamppost" の要素を指す： An IRI can also address a particular element within an XML document by including an IRI fragment identifier as part of the IRI. An IRI which includes an IRI fragment identifier consists of an optional base IRI, followed by a "#" character, followed by the IRI fragment identifier. For example, the following IRI can be used to specify the element whose ID is "Lamppost" within file someDrawing.svg:

http://example.com/someDrawing.svg#Lamppost

xlink:href 属性に対する変更

木内の要素の xlink:href 属性が、何らかの手段（スクリプトや宣言的アニメーションなど）により新たなリソースを参照する形に変更された場合、既存のリソースはその新たなリソースに置換され、適切に描画されなければならない。 script 要素の xlink:href 属性が変更された際におけるスクリプト利用の文脈特有の効果については スクリプトの処理 を見よ。 If the 'xlink:href' attribute of an element in the tree is altered by any means (e.g. script, declarative animation) such that a new resource is referenced, the new resource must replace the existing resource, and must be rendered as appropriate. For specific effects on the scripting context when a 'script' element's 'xlink:href' attribute is altered, see Script processing.

14.1.2 IRI と URI

国際化リソース識別子（ IRI ）は統一リソース識別子（ URI ）をより一般化する補完である。 IRI は Universal Character Set [UNICODE] に属する文字の連なりである。 URI はそれよりはるかに限定された文字の集合からなる。すべての URI はすでに IRI に適合している。 IRI から URI への対応は IRI 仕様に定義されているので、XML 文書内では URI の代わりに IRI をリソースの識別に用いることができる。プロトコルが IRI を直接サポートしていない場合、ネットワーク上のアドレス解決のために IRI を URI に変換できる。 Internationalized Resource Identifiers (IRIs) are a more generalized complement to Uniform Resource Identifiers (URIs). An IRI is a sequence of characters from the Universal Character Set [UNICODE]. A URI is constructed from a much more restricted set of characters. All URIs are already conformant IRIs. A mapping from IRIs to URIs is defined by the IRI specification, which means that IRIs can be used instead of URIs in XML documents, to identify resources. IRIs can be converted to URIs for resolution on a network, if the protocol does not support IRIs directly.

以前のバージョンの SVG では、 XLink にならい、 IRI 参照型を URI または、特定のエスケープ処理を施した結果が URI 参照にならなければならない文字の連なり として定義した。エスケープの手続きは XLink 1.0 仕様 [XLINK10] と W3C の「 XML スキーマ第２部：データ型」仕様 [SCHEMA2] でも繰り返された。この模倣は誤りと分岐の可能性を導くものであったが、 IRI 仕様が標準化されていなかったために行われた。 Previous versions of SVG, following XLink, defined a IRI reference type as a URI or as a sequence of characters which must result in a URI reference after a particular escaping procedure was applied. The escaping procedure was repeated in the XLink 1.0 specification [XLINK10], and in the W3C XML Schema Part 2: Datatypes specification [SCHEMA2]. This copying introduced the possibility of error and divergence, but was done because the IRI specification was not yet standardized.

この仕様では、 IRI を URI に変換する、この「URI または文字列＋アルゴリズム」およびエスケープの仕方に用いられている IRI の正しい用語を、 IETF 標準提案になった IRI 仕様 [RFC3987] への参照から定義されるものとする。他の W3C 仕様はある程度の期間の後、これらのエスケープ手続きの重複した記述を削除し、 IRI を直接参照するように改められることが予期されている。 In this specification, the correct term IRI is used for this "URI or sequence of characters plus an algorithm" and the escaping method, which turns IRIs into URIs, is defined by reference to the IRI specification [RFC3987], which has since become an IETF Proposed Standard. Other W3C specifications are expected to be revised over time to remove these duplicate descriptions of the escaping procedure and to refer to IRI directly.

14.1.3 構文形式： IRI と FuncIRI

IRI は xlink:href 属性で利用される。一部の属性では IRI とテキスト文字列が内容に許されている。文字列か相対 IRI かの区別を明確にするため、関数表記 <FuncIRI> が用いられる。これは単純に関数表記で区切られた IRI である。注記： 歴史的な理由から、 CSS 仕様との互換性をとるため、区切り子は "url(" と ")" になっている。 FuncIRI 形式は 呈示属性 と ナビゲーション属性 で用いられる。 IRIs are used in the 'xlink:href' attribute. Some attributes allow both IRIs and text strings as content. To disambiguate a text string from a relative IRI, the functional notation <FuncIRI> is used. This is simply an IRI delimited with a functional notation. Note: For historical reasons, the delimiters are "url(" and ")", for compatibility with the CSS specifications. The FuncIRI form is used in presentation attributes and navigation attributes.

SVG では広範に渡り他のオブジェクトへの IRI 参照を絶対と相対の両方において利用する。例えば、矩形に線型グラデーションによる fill を行うには、まず次のように linearGradient 要素を定義して ID を与える。 SVG makes extensive use of IRI references, both absolute and relative, to 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:

<linearGradient xml:id="MyGradient">...</linearGradient>

次に、線型グラデーションへの参照を矩形の fill プロパティの値として与える： You then reference the linear gradient as the value of the 'fill' property for the rectangle, as in the following example:

<rect fill="url(#MyGradient)"/>

14.1.4 参照の制約

IRI 参照を利用する要素の一部には参照に制約が課される。各要素に対しどの種類の IRI 参照が許されるかを下の表に示す。 SVG においては、 IRI 参照は、次の５分類うちの１つ以上の分類に属する： Some of the elements using IRI references have restrictions on them. Which kinds of IRI references that are allowed on each element is listed in the table below. In SVG, IRI references can be categorized as being one (or more) of the following five types:

• A: 現在の文書内の素片への参照（ '#someelement' 等）。参照先の素片が 現在の SVG 文書片 内に存在しない場合、参照が 無効な IRI 参照 になるかどうかは ホスト言語 により定められる。 A: A reference to a fragment within the current document (e.g. '#someelement'). If the referenced fragment is not within the current SVG document fragment, then whether the reference is an invalid IRI reference or not is defined by the host language.

• B: 外部文書内の素片への参照（ 'afile.svg#anelement' 等）。 B: A reference to a fragment within an external document (e.g. 'afile.svg#anelement').

• C: SVG 文書全体への参照（ 'afile.svg' 等）。 C: A reference to an entire SVG document (e.g. 'afile.svg').

• D: 素片を利用するかどうかに関係無く、 SVG 以外のメディアリソースへの参照（ 'someimage.jpg' や 'somecontainer#fragment' 等）。適用可能な場合は表内にサポートされるメディア型も示す。 D: A reference to a media resource other than SVG, with or without the use fragments (e.g. 'someimage.jpg' or 'somecontainer#fragment'). Where applicable, the table shows the supported media types.

• E: data: IRI （ 'data:image/jpeg;base64,/9j…' 等） [RFC2397] 。 data: IRI は XML においては、参照する要素を所有する文書とは異なる文書として解決されるが、データは IRI 自身の一部としてすでに読み込まれていることに注意。 E: A data: IRI (e.g. 'data:image/jpeg;base64,/9j…') [RFC2397]. Note that data: IRIs, if XML, resolve to a document that is distinct from the referencing element's owner document, however the data is already loaded as it is part of the IRI itself.

上の A – E ５種類の IRI のそれぞれに下の参照制約表の各列が対応し、表の各行の属性に対しその列の形式の参照が許されるかどうかを示す。下の表の制約を満たさない IRI 参照は 無効な IRI 参照 になる。 For each of the above five IRI types, A – E, there is a column in the reference restriction table below indicating whether the given attribute is allowed to have a reference of the given form. An IRI reference that does not comply to the restrictions in the table below is an invalid IRI reference.

加えて、解決できない IRI 参照 は 無効な IRI 参照 になる。 IRI 参照 が解決できない理由には以下の例が含まれる： Additionally, any IRI reference which cannot be resolved is an invalid IRI reference. Examples of reasons for an IRI reference to be unable to be resolved include:

• リソースが外部リソースで入手できない（例えば UA がリソースを保有しているネットワークのロケーションへ接続できず、リソースがローカルにもキャッシュされていないなど）。 The resource is an external resource and is not available (for example, the user agent cannot connect to the location on the network which stores the resource, and the resource is not cached locally).

• IRI 参照 が存在しないローカルの要素を指している（例えば use 要素の xlink:href が存在しない要素を参照している）。 The IRI reference is to a local element that does not exist (for example, a 'use' element whose 'xlink:href' references a non-existent element).

• IRI 参照 が存在しないリソースを指している（例えば image 要素が HTTP リソースを参照した結果、レスポンスボディがサポートされているラスター画像リソースを含んでいても、 404 レスポンスコードが返されたとき）。 The IRI reference is to a resource that does not exist (for example, an 'image' element that references an HTTP resource that results in a 404 response code, even if the response body contains an otherwise supported raster image resource).

無効な IRI 参照 を持つ属性に要求される処理についてはそれぞれの属性の定義に記述されている。参照元の要素またはその先祖の一つで externalResourcesRequired 属性が 'true' に設定されている場合、未解決の外部 IRI 参照 に際しては特別な処理が行われることになる（ 外部リソース を見よ）。 Any required processing for an attribute with an invalid IRI reference is described in the attribute definition. Note that when the 'externalResourcesRequired' attribute has been set to 'true' on the referencing element or one of its ancestors, then an unresolved external IRI reference will result in special handling (see External resources).

循環する IRI 参照 は エラー。 循環参照がいつ検知され中断されるかは SVG-UA によりまちまちなので、適合 SVG 文書片は循環参照に依存してはならない。循環参照の例には次が含まれる： A circular IRI reference is an error. Because SVG user agents may vary on when they first detect and abort a circular reference, conforming SVG document fragments must not rely upon circular references. Examples of circular references include:

• 直接的または間接的に自身を参照する use 要素。次の SVG 文書片 のように： A 'use' element that directly or indirectly references itself, as in the following SVG document fragment:

  <svg xmlns='http://www.w3.org/2000/svg'
       xmlns:xlink='http://www.w3.org/1999/xlink'
       version='1.2' baseProfile='tiny'>
  
    <!-- 'use' による循環参照の例 -->
    <title>Example of a circular reference with 'use'</title>
  
    <g id='a'>
      <text>ABC</text>
      <use xlink:href='#b'/>
    </g>
    <g id='b'>
      <text>DEF</text>
      <use xlink:href='#a'/>
    </g>
  </svg>

• 現在の SVG 文書片 を含む文書を直接的または間接的に参照する animation 要素。次の例のように： An 'animation' element that directly or indirectly references the document that contains the current SVG document fragment, as in the following example:

  <svg xmlns='http://www.w3.org/2000/svg'
       xmlns:xlink='http://www.w3.org/1999/xlink'
       version='1.2' baseProfile='tiny'>
  
    <!-- 'animation' による循環参照の例 -->
    <title>Example of a circular reference with 'animation'</title>
  
    <animation xlink:href='#' width='100' height='100'/>
  </svg>

参照先の要素は可能な限り defs 要素内に定義することが推奨される。要素のうち linearGradient と radialGradient 要素は常に参照の対象になる。これらの要素を defs 要素内に定義することで SVG 内容も理解され易くなりアクセス性も向上する。 It is recommended that, wherever possible, referenced elements be defined inside of a 'defs' element. Among the elements that are always referenced are 'linearGradient' and 'radialGradient'. Defining these elements inside of a 'defs' element promotes understandability of the SVG content and thus promotes accessibility.

14.1.5 IRI 参照属性

IRI 参照は通常 XLink [XLink] 名前空間の href 属性で指定される。例えば、接頭辞 'xlink' が XLink 名前空間の属性に利用される場合、その属性名は xlink:href で指定できる。この属性の値は望ましいリソース（または素片識別子があれば二次のリソース）への IRI 参照になる。 IRI references are normally specified with an 'href' attribute in the XLink [XLink] namespace. For example, if the prefix of 'xlink' is used for attributes in the XLink namespace, then the attribute is be specified as 'xlink:href'. The value of this attribute forms a reference for the desired resource (or secondary resource, if there is a fragment identifier).

href 属性の値は 国際化リソース識別子 でなければならない。 The value of the 'href' attribute must be an Internationalized Resource Identifier.

HTTP などのプロトコルが IRI を直接サポートしていない場合、 IRI は SVG の実装により IRI 仕様 [RFC3987 3.1 節に従って URI へ変換される。 If the protocol, such as HTTP, does not support IRIs directly, the IRI is converted to a URI by the SVG implementation, as described in section 3.1 of the IRI specification [RFC3987.

アプリケーションにとっては値が IRI 参照であるかどうかチェックすることは非現実的なことなので、この仕様はこの事項については IRI 仕様 の模範に従うだけであり、 SVG アプリケーションにそのような適合性テストの要件を課すものではない。 【参考】 Because it is impractical for any application to check that a value is an IRI reference, this specification follows the lead of the IRI Specification in this matter and imposes no such conformance testing requirement on SVG applications.

IRI 参照が相対参照の場合、使用される前に XML Base [XML-BASE] に述べられている方法で絶対参照版が算出されなければならない。 If the IRI reference is relative, its absolute version must be computed by the method described in XML Base before use [XML-BASE].

参照先のリソースについての補足情報を追加の XLink 属性で指定できる。 Additional XLink attributes can be specified that provide supplemental information regarding the referenced resource.

    <define name='svg.XLinkBase.attr' combine='interleave'>
      <optional>
        <attribute name='xlink:type' svg:animatable='true' svg:inheritable='false'>
          <value>simple</value>
        </attribute>
      </optional>
      <optional>
        <attribute name='xlink:role' svg:animatable='false' svg:inheritable='false'>
          <ref name='IRI.datatype'/>
        </attribute>
      </optional>
      <optional>
        <attribute name='xlink:arcrole' svg:animatable='false' svg:inheritable='false'>
          <ref name='IRI.datatype'/>
        </attribute>
      </optional>
      <optional>
        <attribute name='xlink:title' svg:animatable='false' svg:inheritable='false'><text/></attribute>
      </optional>
    </define>

    <define name='svg.XLinkHrefRequired.attr' combine='interleave'>
      <optional>
        <attribute name='xlink:href' svg:animatable='true' svg:inheritable='false'>
          <ref name='IRI.datatype'/>
        </attribute>
      </optional>
    </define>

    <define name='svg.XLinkBaseRequired.attr' combine='interleave'>
      <ref name='svg.XLinkBase.attr'/>
      <ref name='svg.XLinkHrefRequired.attr'/>
    </define>


    <define name='svg.XLinkActuateOnLoad.attr' combine='interleave'>
      <optional>
        <attribute name='xlink:actuate' svg:animatable='false' svg:inheritable='false'>
          <value>onLoad</value>
        </attribute>
      </optional>
    </define>

    <define name='svg.XLinkShowOther.attr' combine='interleave'>
      <optional>
        <attribute name='xlink:show' svg:animatable='false' svg:inheritable='false'>
          <value>other</value>
        </attribute>
      </optional>
    </define>


    <define name='svg.XLinkEmbed.attr' combine='interleave'>
      <optional>
        <attribute name='xlink:show' svg:animatable='false' svg:inheritable='false'>
          <value>embed</value>
        </attribute>
      </optional>
      <ref name='svg.XLinkActuateOnLoad.attr'/>
      <ref name='svg.XLinkBaseRequired.attr'/>
    </define>


    <define name='svg.XLinkRequired.attr' combine='interleave'>
      <ref name='svg.XLinkShowOther.attr'/>
      <ref name='svg.XLinkActuateOnLoad.attr'/>
      <ref name='svg.XLinkBaseRequired.attr'/>
    </define>


    <define name='svg.XLinkReplace.attr' combine='interleave'>
      <optional>
        <attribute name='xlink:show' svg:animatable='false' svg:inheritable='false'>
          <choice>
            <value>new</value>
            <value>replace</value>
          </choice>
        </attribute>
      </optional>
      <optional>
        <attribute name='xlink:actuate' svg:animatable='false' svg:inheritable='false'>
          <value>onRequest</value>
        </attribute>
      </optional>
      <ref name='svg.XLinkBaseRequired.attr'/>
    </define>

    <define name='svg.XLink.attr' combine='interleave'>
      <optional>
        <ref name='svg.XLinkHrefRequired.attr'/>
      </optional>
      <ref name='svg.XLinkShowOther.attr'/>
      <ref name='svg.XLinkActuateOnLoad.attr'/>
      <ref name='svg.XLinkBase.attr'/>
    </define>

いかなる場合でも、上記 XLink 属性のいずれかを SVG 内容で利用する際には、「XML 名前空間 1.0」 または 「XML 名前空間 1.0」勧告 [XML-NS10][XML-NS] に適合するように XLink 名前空間宣言が明示的に与えられなければならない。このような XLink 名前空間宣言を与える簡単な方法の一つは XLink 属性を利用する内容の svg 要素に XLink 名前空間のための xmlns 属性を与えることである。 In all cases, for compliance with either the "Namespaces in XML 1.0" or the "Namespaces in XML 1.1" Recommendation [XML-NS10][XML-NS], an explicit XLink namespace declaration must be provided whenever one of the above XLink attributes is used within SVG content. One simple way to provide such an XLink namespace declaration is to include an 'xmlns' attribute for the XLink namespace on the 'svg' element for content that uses XLink attributes.

Example: XLink 名前空間宣言

<?xml version="1.0"?>
<svg xmlns:xlink="http://www.w3.org/1999/xlink"
  xmlns="http://www.w3.org/2000/svg" version="1.2" baseProfile="tiny">
  <!-- SVG のそれに加えて XLink の名前空間も宣言 -->
  <desc>Declaring the XLink namespace, as well as the SVG one</desc>
  <image xlink:href="foo.png"/>
</svg>

Example: use とアニメーション

下の２つのファイルはその下に示す use とアニメーションの例から参照されるものになる。 The two files below are the referenced files in the 'use' and animation examples further down.

<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" 
     version="1.2" baseProfile="tiny" 
     xml:id="animationRef" width="150" height="50" viewBox="0 0 150 50" fill="inherit">  

    <rect xml:id="aMovingRect" width="50" height="50" rx="5" ry="5" fill="inherit" stroke-width="3" stroke="black">
         <animateTransform attributeName="transform" type="translate" values="0,0;0,100" begin="0" dur="2" fill="freeze"/>
    </rect>
</svg>

<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" 
     version="1.2" baseProfile="tiny" 
     xml:id="animationRef" width="150" height="50" viewBox="0 0 150 50" fill="inherit">  

    <rect xml:id="aMovingRect" width="50" height="50" rx="5" ry="5" fill="rgb(255,28,141)" stroke-width="3" stroke="black">
         <animateTransform attributeName="transform" type="translate" values="0,0;0,100" begin="0" dur="2" fill="freeze"/>
    </rect>
</svg>

次の例に animation 要素から SVG 内容を参照する方法を示す。 animation 要素から参照される内容にプロパティが継承される様子を明らかにするために fill に異なった値を与えている。 The following example illustrates how to reference SVG content from the 'animation' element. Different 'fill' values are used to show the way properties are inherited on content referenced from the 'animation' element.

<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" 
     version="1.2" baseProfile="tiny" width="100%" height="100%" viewBox="0 0 580 400">  

    <g fill="rgb(157,0,79)">
        <animation x="20" xlink:href="referencedRect.svg"/>
        <animation x="100"  xlink:href="referencedRect2.svg"/>
        <animation begin="1" x="180" viewport-fill="rgb(255,28,141)" xlink:href="referencedRect.svg"/>
    </g>
    
</svg>

下の画像が上のアニメーションの例を正しく描画した結果を表すものになる。矢印がアニメーションを示す。灰色がかった矩形が初期状態（ time=0 ）を表し、色付きの矩形が終了状態（アニメーションが完了）を表す。 The image below shows the correct rendering of the animation example above. The arrows indicates the animation. The grayed rectangles shows the initial state (i.e. time=0), the colored rectangles shows the final state (animations are completed).

次の例に use 要素から SVG 内容へ参照する種々の方法を示す。 use 要素から参照される内容へのプロパティ継承のされ方を明らかにするために fill に異なった値を与えている。 The following example illustrates the different ways SVG content can be referenced from a 'use' element. Different 'fill' values are used to show the way properties are inherited on content referenced from the 'use' element.

<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" 
     version="1.2" baseProfile="tiny" width="100%" height="100%" viewBox="0 0 580 400">  
    <defs>
        <g fill="green">
            <rect xml:id="aMovingRect" width="50" height="50" rx="5" ry="5" fill="inherit" stroke-width="3" stroke="black">
                <animateTransform attributeName="transform" type="translate" values="0,0;0,100" begin="0" dur="2" fill="freeze"/>
            </rect>
        </g>
    </defs>
    
    <g fill="rgb(157,0,79)">
        <use x="20" xlink:href="#aMovingRect"/>
            
        <use x="100" fill="rgb(255,28,141)" xlink:href="#aMovingRect"/>
    
        <use x="180" xlink:href="referencedRect.svg#aMovingRect"/>

        <use x="260" fill="rgb(255,28,141)" xlink:href="referencedRect.svg#aMovingRect"/>
    </g>

</svg>

下の画像は上の use の例の正しい描画結果を表すものになる。矢印がアニメーションを示す。灰色がかった矩形が初期状態（ time=0 ）を表し、色付きの矩形が終了状態（アニメーションが完了）を表す。 The image below shows the correct rendering of the use example above. The arrows indicates the animation. The grayed rectangles shows the initial state (i.e. time=0), the colored rectangles shows the final state (animations are completed).

14.1.6 文書への外部参照の処理

SVG-UA が外部参照を文書へ解決する際、文書がどのように読み込まれ処理されるかは、文書がどのように参照されるかに依存する。下に定めるように、文書は一次文書（ primary document ）またはリソース文書（ resource document ）のいずれかに分類され、この分類が外部参照の読み込みに関する文書の処理を決定する。 When an SVG user agent resolves an external reference to a document, how the document is loaded and processed depends on how the document was referenced. As defined below, a document is classified as either a primary document or a resource document, and this classification determines the document's processing with respect to loading of external references.

一次文書は UA により全体として表示されるものである。特に次のものは一次文書になる： A primary document is one that is to be presented in whole by the user agent. Specifically, the following are classified as primary documents:

• 文書全体、それ自体が 独立 SVG 文書 の形のもの、またはそれ自体が SVG 文書片 を含み得る他の何らかの文書の形のもので、 UA により表示のために読み込まれたもの：ウェブブラウザでその IRI へ移動したときなど：ブラウザのアドレスバーへの IRI の入力, IRI のリンクのクリック, Location::assign() メソッドの呼び出しなどによるもの（ HTML 5 UA においては、これは文書が top-level browsing context の一部になるときである（ [HTML5], 4.1.1 節）。 An entire document, be it an SVG stand-alone document or some other document that can contain SVG document fragments, that is loaded into a user agent for presentation, such as when navigating a web browser to an IRI, whether by typing the IRI into the browser's address bar, clicking on a link to that IRI, or having the Location::assign() method invoked. (In an HTML 5 user agent, this is when a document is part of a top-level browsing context ([HTML5], section 4.1.1).)

• animation 要素に参照される形で読み込まれた SVG 文書全体。 An entire SVG document that is loaded due to it being referenced by an 'animation' element.

• HTML の object や iframe 要素などを用いて親の 非 SVG 文書に埋め込む形に参照されて読み込まれた文書。 A document that is loaded due to it being referenced for inclusion by a parent non-SVG document for presentation, such as using the HTML 'object' or 'iframe' elements.

リソース文書はその一部分がリソースとして SVG 文書片 から参照され読み込まれた文書になる。特に次の種類の外部参照はすべて要素への参照であり、読み込まれた文書はリソース文書に分類される： A resource document is a document that has been loaded because parts of it are referenced as resources by an SVG document fragment. Specifically, the following kinds of external references, all of which are references to elements, will cause the loaded document to be classified as a resource document:

• use 要素の xlink:href 属性。 The 'xlink:href' attribute on a 'use' element.

• font-face-uri 要素の xlink:href 属性。 The 'xlink:href' attribute on a 'font-face-uri' element.

• fill または stroke プロパティのペイントサーバ参照。 A paint server reference in a 'fill' or 'stroke' property.

一次文書とリソース文書のいずれも（ 最も根元の 'svg' 要素 が document 要素の）完全な SVG 文書になる必要は無いことに注意。いずれも SVG 文書片 を含む非 SVG 文書になり得る。 Note that neither a primary document nor a resource document need be a complete SVG document (with the rootmost 'svg' element being the document element). Both may be non-SVG documents that contain SVG document fragments.

それぞれの一次文書は IRI からリソース文書へ対応付ける辞書を持つ。この辞書は一次文書（またはそのリソース文書の一つ）の内部の SVG 文書片 から参照されるので、リソース文書が読み込まれようとする度に利用される。リソース文書の読み込み前に、その IRI が一次文書の辞書内で検索され、すでに読み込み済みかどうかが決定される。もしそうなら、別個の文書インスタンスが作られる代わりにその読み込み済み文書が利用される。従って、それぞれの一次文書に対し与えられたリソース文書の読み込みは一度限りになる。しかしながら、一次文書は常に別々の自立した文書インスタンスであり、異なる一次文書間ではリソース文書は共有されない。 Each primary document maintains a dictionary that maps IRIs to resource documents. This dictionary is used whenever a resource document is to be loaded because an SVG document fragment within the primary document (or one of its resource documents) references it. Before loading a resource document, its IRI is first looked up in the primary document's dictionary to determine if it has already been loaded. If so, then that already-loaded document is used instead of creating a separate document instance. Thus, for each primary document, a given resource document is loaded only once. Primary documents, however, are always separate, self-contained document instances, and resource documents are not shared between different primary documents.

リソース文書辞書のキーとして用いられる IRI は、適用し得る基底 IRI による解決が施された絶対 IRI でなければならず、辞書キーの比較は 国際化リソース識別子 [RFC3987] 5.3.1 節で定められた Simple String Comparison により行われなければならない。 The IRI used as the key in the dictionary of resource documents must be the absolute IRI after resolving it against any applicable base IRI, and comparisons of the dictionary keys must be performed using a Simple String Comparison, as defined in section 5.3.1 of Internationalized Resource Identifiers [RFC3987].

文書が一次文書かリソース文書かどうかに関わらず、一旦読み込まれた後の処理は同じである： 文書内のそれぞれの SVG 文書片 は別々の SVG 処理文脈で活動する：イベント処理, スクリプトの実行, アニメーションの時間軸の作成, アニメーションの実行, スタイルシートの適用（ SVG-UA からサポートされていれば）, 等々。 リソース文書は単なる静的 DOM ではないので、加えられる任意の変更（スクリプトによる変更やアニメーションによる表示値の変化など）はリソース文書へのすべての参照を通して可視化する。 Whether a document is a primary document or a resource document, its processing once loaded is the same: each SVG document fragment within the document acts as a separate SVG processing context in which events are fired, scripts are executed, an animation timeline is created and animations are run, stylesheets are applied (if supported by the SVG user agent), and so on. Since a resource document is not just a static DOM, any changes to it (be they modifications by script or changing presentation values with animation) will be visible through all references to that resource document.

異なる一次文書からのリソースへの IRI 参照 は、論理的には別々のリソース文書がインスタンス化される結果になるので、一般的には SVG-UA はメモリ内のリソース文書のインスタンスを１つにしてメモリを節約することはできない。多数の一次文書がすべて単独の巨大な共通のリソースファイルを参照する場合、おそらく大量のメモリ消費がもたらされることになる。もし、 SVG-UA が、単独のインスタンスをメモリ内で共有しても、それぞれの一次文書が全く同じにふるまうことが証明できるのなら（例えばリソース文書に対するコピーオンライトのセマンティクスを用いるなどにより）、そのような最適化は当然実行してもよい。 Note that since IRI references to resources from different primary documents will result in logically separate resource documents being instantiated, an SVG user agent will in general not be able to conserve memory by having only one instance of the resource document in memory. In the case that many primary documents all have references to a single, large, common resource file, this will likely result in a large amount of memory consumed. If the SVG user agent is able to prove that the primary documents will behave exactly the same if a single instance is shared in memory (by using copy-on-write semantics for the resource documents, for example), then such an optimization may of course be performed.

メディアや外部スクリプトなどの他の種類の文書への参照は、一次文書やリソース文書には分類されない。同じ IRI のメディアに対する多重参照に対しては、常に別々の時間軸が作成される。 References to any other kinds of document, such as media or external scripts, are not classified as primary or resource documents. Multiple references to media at a particular IRI always result in separate timelines being created.

14.2 SVG 内容から外へのリンク： a 要素

SVG は（ハイパーリンクあるいはウェブリンクとしても知られる）リンクを指示するために HTML の a 要素に類似した a 要素を提供する。 SVG ではすべてのリンク定義に XLink [XLINK10] が用いられる。 SVG provides an 'a' element, analogous to HTML's 'a' element, to indicate links (also known as hyperlinks or Web links). SVG uses XLink [XLINK10] for all link definitions.

SVG Tiny 1.2 においては、 UA は XLink における 単純リンク （simple link）のみをサポートすればよい。それぞれの単純リンクはローカルとリモートのきっちり２つのリソースを、アーク（ arc ）が前者から後者へ向くように結び付ける。 SVG Tiny 1.2 only requires that user agents support XLink's notion of simple links. Each simple link associates exactly two resources, one local and one remote, with an arc going from the former to the latter.

単純リンクは a 要素内の描画される要素ごとに個別に定められる。例えば a 要素が複数の circle 要素を含むならば、各 circle ごとにリンクが作成される。 a 要素内の描画される各要素はローカルリソース（リンク元のアンカー）になる。 A simple link is defined for each separate rendered element contained within the 'a' element; thus, if the 'a' element contains three 'circle' elements, a link is created for each circle. For each rendered element within an 'a' element, the given rendered element is the local resource (the source anchor for the link).

リモートリソース（リンク先）は a 要素の XLink href 属性で指定される IRI により定められる。リモートリソースは任意のウェブリソース（例えば画像, 動画クリップ, サウンドバイト（sound bite）, プログラム, 別の SVG 文書, HTML文書, 等々）が可能である。これらリンクの起動により（マウスクリック, キーボード入力, ボイスコマンド, 等々）、利用者はこれらのリソースへのハイパーリンクを辿れるようになる。 The remote resource (the destination for the link) is defined by an IRI specified by the XLink 'href' attribute on the 'a' element. The remote resource may be any Web resource (e.g., an image, a video clip, a sound bite, a program, another SVG document, an HTML document, etc.). By activating these links (by clicking with the mouse, through keyboard input, voice commands, etc.), users may traverse hyperlinks to these resources.

IRI が 現在の SVG 文書片 内の アニメーション要素 を指している場合、 a 要素の起動は SMIL 2.1 ([SMIL21], 10.4.3 節) に定められている アニメーションへのハイパーリンク になる。 If the IRI identifies an animation element within the current SVG document fragment, then activating the 'a' element will hyperlink to the animation, as defined in SMIL 2.1 ([SMIL21], section 10.4.3).

Example 17_01 では楕円にリンクをあてがっている。 Example 17_01 assigns a link to an ellipse.

Example: 17_01.svg

<?xml version="1.0"?>
<svg width="5cm" height="3cm" viewBox="0 0 5 3" version="1.2" baseProfile="tiny"
     xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">

  <title>Example 17_01</title>
  <!-- 楕円形の上の単純リンク -->
  <desc> A simple link on an ellipse. </desc>
  <rect x=".01" y=".01" width="4.98" height="2.98" 
        fill="none" stroke="blue"  stroke-width=".03"/>
  <a xlink:href="http://www.w3.org/">
    <ellipse cx="2.5" cy="1.5" rx="2" ry="1"
             fill="red" />
  </a>
</svg>

上の SVG ファイルが SVG と HTML をサポートする UA で表示された場合、楕円のクリックにより現在のウィンドウまたはフレームが W3C のホームページに置き換えられる。 If the above SVG file is viewed by a user agent that supports both SVG and HTML, then clicking on the ellipse will cause the current window or frame to be replaced by the W3C home page.

a の要素定義スキーマと内容モデルはここでは定義しない。生じ得るすべての場所で定義される。 The element definition schema and content model for 'a' is not defined here. It is defined in all the places it can occur.

    <define name='a.AT' combine='interleave'>
      <ref name='svg.Core.attr'/>
      <ref name='svg.Conditional.attr'/>
      <ref name='svg.Properties.attr'/>
      <ref name='svg.FocusHighlight.attr'/>
      <ref name='svg.External.attr'/>
      <ref name='svg.Focus.attr'/>
      <ref name='svg.Transform.attr'/>
      <ref name='svg.XLinkReplace.attr'/>
      <optional>
        <attribute name='target' svg:animatable='true' svg:inheritable='false'>
          <choice>
            <value>_replace</value>
            <value>_self</value>
            <value>_parent</value>
            <value>_top</value>
            <value>_blank</value>
            <ref name='XML-Name.datatype'/>
          </choice>
        </attribute>
      </optional>
    </define>

14.2.1 リンクの指示

通常、 HTML UA ではアンカー要素の内容をスタイル付けして、それらがリンクであることを指示するのがならわしになっている。例えば、下線を引いてテキストの色を変えたり、画像の周囲や他の置換内容に色付きの境界線を与えるなど。 SVG は不規則な図形と複雑なリンク構造（リンク内部に他のリンクを入れるなど）を備えた視覚的言語であり、内容の見かけに対するより精確な制御が意図されているので、 SVG-UA は a 要素の子内容に対する既定のスタイル付けを与えるべきではなく、文書作成者にリンクのスタイル制御を任せるべきである。 Typically, HTML user agents, by convention, style the content of anchor elements to indicate that they are links, for example by underlining and changing the color of text and creating a colored border around images and other replacement content. Because SVG is a visual language with irregular shapes and complex link structure (e.g. allowing links within other links), and is intended to allow more precise control over the appearance of the content, SVG user agents should not provide default styling to child content of an 'a' element, instead allowing authors to control the linking conventions.

しかしながら、利用者にリンクが明らかになるように、かつ、各リンクについて詳細な情報が提供されるようにするため、 SVG-UA はリンクがスコープに入った際にそれとわかる表示を与えるべきである。リンクは a 要素の子要素のうち一つがポインタ装置のカーソルと重なるとき、または、その要素が現在 フォーカス を得ているときにスコープに入るものとする。 UA はリンクがスコープに入った際はそれを伝えるためにスコープ指示を変化させるべきであり（例えば、カーソルを人差し指の形に変えたり フォーカスハイライト に色変化を付けてリンク状態を示すなど）、リンク URI を表示すべきであり（ステータスバーに表示させたり音声に読み上げるなど）、リンクに関し文書作成者が用意した情報を表示すべきである（ツールチップなどで）。リンクに関する情報を利用者に提供するためには、文書作成者はリンクに適切な xlink:title 属性を与えるべきである。 However, in order to ensure that links are obvious to users and to provide detailed information about each link, SVG user agents should provide a clear indicator when a link is in scope. A link shall be considered to be in scope if one of the child elements of that 'a' element has a pointer device cursor hovered over it or when that element is the currently focused element. The user agent should change the scope indicator to signal that a link is in scope (e.g. the cursor may be changed to a pointing hand, or the focus highlight may be color-coded to indicate the status of the link), should indicate the URI of the link (by displaying it in a status bar, or reading it aloud, for example), and should display any author-supplied information about the link (as with a tooltip). Authors should use the 'xlink:title' attribute appropriately on links, in order to provide information about the link to users.

14.3 SVG 内容の中へのリンク：IRI 素片と SVG ビュー

14.3.1 IRI 素片と SVG ビューの概要

SVG 内容は通常何らかの絵や図面を表現するので、 SVG ビュー と呼ばれる文書の特定の部分への、その部分を大写しに表示するための初期変換を指示するビューへのリンクが一般的な要求として存在する。 Because SVG content often represents a picture or drawing of something, a common need is to link into a particular view of the document, where a view indicates the initial transformations so as to present a closeup of a particular section of the document.

14.3.2 SVG 素片識別子

SVG 文書の特定のビューへリンクさせるためには、 IRI 素片識別子を SVG 素片識別子として正しい形式にしなければならない。 SVG 素片識別子は、 MIME メディアタイプ "image/svg+xml" のリソースを指す、 IRI の「セレクタ（ "selector" ）」または「素片識別子」（ "fragment identifier" ）の持つ意味を定める。 To link into a particular view of an SVG document, the IRI fragment identifier must be a correctly formed SVG fragment identifier. An SVG fragment identifier defines the meaning of the "selector" or "fragment identifier" portion of IRIs that locate resources of MIME media type "image/svg+xml".

SVG 素片識別子には２通りの形式がある： An SVG fragment identifier can come in two forms:

1. 略式の無装飾名（bare name）形式（例えば someDrawing.svg#someView ）による場所の指定。この形式のアドレス指定は SVG 要素の ID によるアドレス指定を可能にするものであり、 HTML の旧版 および XPointer Framework [XPTRFW] で定式化されている略式の無装飾名による、文書片のアドレス指定の仕組みと互換性がある。 Shorthand bare name form of addressing (e.g., someDrawing.svg#someView). This form of addressing, which allows addressing an SVG element by its ID, is compatible with the fragment addressing mechanism for older versions of HTML and the shorthand bare name formulation in XPointer Framework [XPTRFW].
2. SVG ビュー指定（例えば someDrawing.svg#svgView(transform(scale(2)) ）。この形式によるアドレス指定は文書の望ましい表示（例えば初期状態において表示される文書の範囲やその拡大倍率）を SVG 素片識別子の中で完全な形で指定する。 SVG ビュー指定の内容は "transform(...)" であり、 g 要素の対応する属性と同じ意味を持つ。 SVG view specification (e.g., someDrawing.svg#svgView(transform(scale(2))). This form of addressing specifies the desired view of the document (e.g., the region of the document to view, the initial zoom level) completely within the SVG fragment specification. The contents of the SVG view specification is "transform(...)" whose parameters have the same meaning that the corresponding attribute has on a 'g' element has).

SVG 素片識別子の構文は次で与えられる： An SVG fragment identifier is defined as follows:

SVGFragmentIdentifier ::= BareName |
                          SVGViewSpec

BareName ::= NCName
SVGViewSpec ::= 'svgView(' SVGViewAttributes ')'
SVGViewAttributes ::= SVGViewAttribute |
                      SVGViewAttribute ';' SVGViewAttributes

SVGViewAttribute ::= transformSpec
transformSpec ::= 'transform(' TransformList ')'

ここで： where:

• NCName は <NCName> 値。 NCName is an <NCName> value.
• TransformList は TransformList 値 に対応する。例えば transform(scale(5)) 。 TransformList corresponds to the TransformList value. For example, transform(scale(5)).

SVG 素片識別子は指定された文法に一致しなければならない。文書作成者は、内容を確固にするためには、数値間のスペースを省略したりスペースをパーセント符号化 文字列やコンマなどへ置換するなどの処理を適切に施すことが推奨される。 An SVG fragment identifier must match the specified grammar. To ensure robust content, authors are recommended to omit spaces between numeric values, or replace these spaces with percent-encoded strings or commas as appropriate.

注記：素片識別子は解決される前に IRI から取り除かれるので、素片内の US-ASCII 以外の文字についてはエスケープを施す必要は無い。 Note: since fragment identifiers are stripped from IRIs before resolution, there is no need to escape any characters in fragments that are outside the repertoire of US-ASCII.

UA が SVG 文書片へのリンクを同じ文書内から、あるいは外部ソースの文書から辿る際には、 SVG 素片識別子は SVG 文書に対する初期ビューを指定するものとする。このことはリンクが SVG の a 要素, HTML アンカー要素 [HTML4] （すなわち HTML の <a href=...> 要素）, XLink [XLINK10] を用いた任意の指定、のいずれであろうと適用される。 UA は、リンクの追跡による効果を決定する際に以下の段階を踏むものとする： When a user agent traverses a link to an SVG document fragment, whether from within the same document or from an external source document, then the SVG fragment identifier shall specify the initial view into the SVG document. This applies whether the link is from an SVG 'a' element, an HTML anchor element [HTML4] (i.e., an <a href=...> element in HTML), or any specification using XLink [XLINK10]. The user agent shall take the following steps in determining the effect of the link traversal:

• SVG 素片識別子が与えられていない場合（例えば someDrawing.svg のように指定された IRI が "#" 文字を含まないとき）、 SVG 文書への初期ビューは 最も根元の 'svg' 要素 のビュー指定属性（ viewBox 等々）を用いて確立されるものとする。 If no SVG fragment identifier is provided (i.e., the specified IRI did not contain a "#" character, such as someDrawing.svg), then the initial view into the SVG document shall be established using the view specification attributes (i.e., viewBox, etc.) on the rootmost 'svg' element.
• SVG 素片識別子が特定の SVG ビューを指す場合（例えば linking-svgView-102-t.svg#svgView(transform(rotate(30, 150, 150))) ）、最も近い先祖の svg 要素で定義される文書片が SVG 素片識別子で与えられた SVG ビュー指定を用いてビューポートに表示されるものとする。 If the SVG fragment identifier addresses specific SVG view (e.g., linking-svgView-102-t.svg#svgView(transform(rotate(30, 150, 150)))), then the document fragment defined by the closest ancestor 'svg' element is displayed in the viewport using the SVG view specification provided by the SVG fragment identifier.
• SVG 素片識別子が要素のアドレスを指定していて（ #rectId や someDrawing.svg#rectId など）、素片識別子に指示された要素が見つかった場合、 SVG 文書の座標系の現在の並進は、特定された要素の 装飾付き包含ボックス の中心がビューポートの中心に位置するように調整されるものとする。 要素の装飾付き包含ボックスが現在のビューポートにはめ込むには大き過ぎる場合、 最も根元の 'svg' 要素 の zoomAndPan 属性が 'disable' に設定されていない場合、ビューポートは再配置のみならず、要素の装飾付き包含ボックスの幅と高さいっぱいになるまで現在の拡縮を変えるものとする。 一方で、対象の要素の【装飾付き】包含ボックスがビューポートよりも小さい場合、ビューポートは確定済みの値に留めるものとする（すなわち、自動的に要素にズームインしない）。 指定された要素が装飾付き包含ボックスを持たない場合、現在の並進と現在の拡縮は確立された値から変わらない。ビューポートの現在の並進や拡縮への変更に関係無く、現在の座標系に対する現在の回転は維持されるものとし（すなわち、対象の装飾付き包含ボックスの中心は、一定の回転角度のまま回転の中心になるものとする）、既存の縦横比も変わらないものとする。 外部リンクから辿られた場合のビューポートは 最も根元の 'svg' 要素 に指定された値により確立されるものとし、内部リンクからの場合の初期ビューポートは、以前のズーム操作（以前のリンクからのナビゲーション, 利用者によるズーム, 現在の座標系に対するスクリプトからの改変, 等々）に対する追加的な調整を行うものとし、追跡（ traversal ）の結果生じた並進や拡縮は既存の座標系を開始状態として利用するものとする。 要素が見つからなかった場合、あるいは装飾付き包含ボックスを持たない場合、ビューポートは動かず、ズームもされない。追跡のいずれの場合においても、ビューは即座に確立され、要素に対する動的なパンや他の派手な並進は行わないものとする。 viewbox は対象の要素の装飾付き包含ボックスのアニメーションに同期して断続的にアニメーションされないものとする。将来版の仕様では、他の仕組みを通した追跡のふるまいのカスタマイズも考えられている。 If the SVG fragment identifier addresses any element (e.g., #rectId or someDrawing.svg#rectId) and the element indicated by the fragment identifier is found, then the current translation of the SVG document's coordinate system shall be adjusted such that the centerpoint of the decorated bounding box of the identified element is positioned in the center of the viewport. If the element's decorated bounding box is too large to fit within the current viewport, and the 'zoomAndPan' attribute of the rootmost 'svg' element is not set to 'disable', then the viewport shall not only reposition but also have the current scale expanded to accommodate the entire width and height of the element's decorated bounding box. By contrast, if the bounding box of the target element is smaller than the viewport, the viewport shall remain at the preestablished values (i.e., it will not automatically zoom in on the element). If the specified element does not have a decorated bounding box, then the current translate and current scale are not changed from the established values. Regardless of changes to the current translation or scale of the viewport, the current rotation of the current coordinate system shall be preserved (that is, the centerpoint of the target decorated bounding box shall be the centerpoint of the rotation, with a constant rotation angle), and the existing aspect ratio shall not be altered. In the case of traversal from an external link, the viewport shall be established by the values specified in the rootmost 'svg' element, and in the case of an internal link, the initial viewport shall additionally be adjusted by any previous zooming operations (e.g. previously navigated links, user zooming, script alterations of the current coordinate system, etc.) such that any translation or scaling that happens as a result of the traversal shall use the existing coordinate system as a starting state. If the element is not found, or does not have a decorated bounding box, then the viewport does not move or zoom. In all cases of traversal, the view shall be established instantly, with no animated panning or other enhanced transition toward the target element. The viewbox shall not be continually animated to match the animations of a target element's decorated bounding box. Future specifications may allow more customizable behavior for traversal through another mechanism.
• SVG 素片識別子が要素を指していてその要素が見つからなかった場合、素片は指定されなかったものとして、 SVG 文書への初期ビューは 最も根元の 'svg' 要素 のビュー指定属性（ viewBox, 等々）を用いて確立されるものとする。 If the SVG fragment identifier addresses any element and the element is not found, the initial view into the SVG document shall be established using the view specification attributes (i.e., viewBox, etc.) on the rootmost 'svg' element, as if no fragment had been specified.

注記： SVG Tiny 1.2 においては、 svg 要素は１個だけである。従って、最も近い先祖の svg 要素と 最も根元の 'svg' 要素 は同じになる。このことは他の SVG プロファイルでは成立せず、区別が重要になる。 Note: In SVG Tiny 1.2, only a single 'svg' element is allowed. Thus, the closest ancestor 'svg' element and the rootmost 'svg' element are the same. This is not true in other profiles of SVG, where the distinction becomes significant.