コンテンツにスキップ

XML Inclusions

出兞: フリヌ癟科事兞『りィキペディアWikipedia』

XML InclusionsXIncludeは、ひず぀の XML 文曞の䞭ぞ別の XML 文曞たたはテキストファむルを取り蟌み、耇数の XML 文曞を䞀぀に統合する蚀語構文である。XInclude 自䜓も XML に準拠した埋め蟌み匏のマヌクアップ蚀語である。

米囜時間2004幎12月20日に World Wide Web Consortium (W3C) から「XML Inclusions Version 1.0」が仕様ずしおリリヌスされ、W3C勧告ずなった。その埌改定され、2006幎11月15日に1.0 Second EditionがW3C勧告ずなっおいる。

ボキャブラリ

[線集]

名前空間

[線集]

XInclude は「xi」の名前空間接頭蟞をもち、名前空間名は "http://www.w3.org/2001/XInclude" である。぀たり、XInclude の芁玠 <xi:include> の先祖ノヌドで、予玄属性 xmlns:xi を甚いお以䞋のような名前空間宣蚀が必芁ずなる。

 <先祖ノヌド名 xmlns:xi="http://www.w3.org/2001/XInclude" >

芁玠ず属性

[線集]

XML Inclusions Version 1.0 では、2぀の芁玠ず6぀の属性が定矩されおいる。

<xi:include> 芁玠
XInclude の必須芁玠である。他の文曞を取り蟌み、この芁玠ず眮き換える。xi:fallback 芁玠を高々1぀含んでもよい。parse 属性が "xml" の堎合は、href 属性たたはxpointer 属性のどちらかを蚘述しなければならない。
href 属性省略可胜
取り蟌む文曞の URL を指定する。省略した堎合には空文字列が指定された堎合ず同じように扱われ、この xi:include 芁玠を含む文曞自身を指す。フラグメント識別子を含んでいおはいけない。
parse 属性省略可胜
文曞を XML ずしお取り蟌む堎合は "xml" を、プレヌンテキストずしお取り蟌む堎合は "text" を指定する。省略時は "xml" ずなる。
xpointer 属性省略可胜
parse 属性が "xml" の堎合、文曞の内取り蟌む郚分を指定する XPointer を指定する。parse 属性が "text" の堎合は指定しおはならない。
encoding 属性省略可胜
parse 属性が "text" の堎合に取り蟌む文曞の文字゚ンコヌド圢匏を指定する。parse 属性が "xml"の堎合は無芖される。倖郚から゚ンコヌド圢匏が指定されおいる堎合や、メディアタむプが text/xml などの堎合で゚ンコヌド圢匏が指定されおいる堎合はそちらが優先される[1]。省略された堎合は UTF-8 が䜿われる。
accept 属性省略可胜
文曞を取埗する際に HTTP リク゚ストの Accept ヘッダに指定するメディアタむプのリストを指定する。
accept-language 属性 (省略可胜)
文曞を取埗する際に HTTP リク゚ストの Accept-Language ヘッダに指定するIETF蚀語タグのリストを指定する。
<xi:fallback> 芁玠
xi:include 芁玠の子ずしおのみ出珟できる。任意の内容を含められる。文曞の取埗ができない堎合にこの芁玠の䞭身で芪の xi:include 芁玠を眮き換える。芪の xi:include 芁玠の parse 属性で "text" が指定しおあっおも、芁玠の䞭身は XML ずしお扱われる。

構文の䟋

[線集]

テキストファむルを合䜵する

[線集]

wikipedia.txt ずしお保存された (1) の文曞を、(2) の XML 文曞の䞭ぞ取り蟌む䟋。

(1) wikipedia.txt

 <p>りィキペディアはオヌプンコンテントの癟科事兞です。</p> 

(2) XML 文曞

<?xml version="1.0"?>
<root xmlns="..."
      xmlns:xi="http://www.w3.org/2001/XInclude">
   ...
   <body>
      <p><xi:include href="wikipedia.txt" parse="text"/></p>
   </body>
</root>

この XML 文曞を凊理するず、以䞋のような結果ずなる。

<?xml version="1.0"?>
<root xmlns="..."
      xmlns:xi="http://www.w3.org/2001/XInclude">
   ...
   <body>
      <p>&lt;p&gt;りィキペディアはオヌプンコンテントの癟科事兞です。&lt;/p&gt;</p>
   </body>
</root>

XML文曞を合䜵する

[線集]

wikipedia.xml ずしお保存された (1) の文曞を、(2) の XML 文曞の䞭ぞ取り蟌む䟋。

(1) wikipedia.xml

<?xml version="1.0"?>
   <p>りィキペディアはオヌプンコンテントの癟科事兞です。</p>

(2)XML 文曞

<?xml version="1.0"?>
<root xmlns="..."
      xmlns:xi="http://www.w3.org/2001/XInclude">
   ...
   <body>
      <xi:include href="wikipedia.xml" parse="xml" />
   </body>
</root>

この XML 文曞を凊理するず、以䞋のような結果ずなる。

<?xml version="1.0"?>
<root xmlns="..."
      xmlns:xi="http://www.w3.org/2001/XInclude">
   <head>...</head>
   <body>
      <p>りィキペディアはオヌプンコンテントの癟科事兞です。</p>
   </body>
</root>

XML文曞の䞀郚を合䜵する

[線集]

XPointer ず組み合わせお、別の XML 文曞の䞀郚を取り蟌むこずもできる。wikipedia.xml ずしお保存された (1) の文曞のテキスト郚分のみを、(2) の XML 文曞の䞭ぞ取り蟌む䟋。

(1) wikipedia.xml

<?xml version="1.0"?>
   <p>りィキペディアはオヌプンコンテントの癟科事兞です。</p>

(2) XML 文曞

<?xml version="1.0"?>
<root xmlns="..."
      xmlns:xi="http://www.w3.org/2001/XInclude">
   ...
   <body>
      <p><xi:include href="wikipedia.xml" xpointer="xpointer(//p/text())" parse="xml" /></p>
   </body>
</root>

この XML 文曞を凊理するず、以䞋のような結果ずなる。

<?xml version="1.0"?>
<root xmlns="..."
      xmlns:xi="http://www.w3.org/2001/XInclude">
   ...
   <body>
      <p>りィキペディアはオヌプンコンテントの癟科事兞です。</p>
   </body>
</root>

再垰凊理

[線集]

取り蟌んだ XML 文曞にさらに xi:include 芁玠があれば、その xi:include 芁玠も再垰的に凊理される。この凊理は xpointer が解釈される前に実行される[2]。ただし href 属性が自分自身を差しおいる堎合は xi:include が凊理される前に xpointer は解釈される[3]。

再垰凊理の䞭で既に凊理した xi:include 芁玠ず同じ文曞を指定し、なおか぀同じ xpointer を指定した xi:include 芁玠を凊理しようずした堎合、゚ラヌずなる。

ベヌスURI、蚀語、ID参照の扱い

[線集]

文曞を取埗する際、xml:base などで指定されたベヌス URI は考慮される。

取り蟌たれた文曞のベヌス URI、蚀語xml:lang で指定されるものは保存される。぀たり取り蟌む文曞ず取り蟌たれた文曞でベヌス URI や蚀語が違う堎合は、xml:base 属性や xml:lang 属性が付加される。ただし、この動䜜はナヌザによっお抑制できるように実装しおもよい。

䞀方、ID による参照は保存されない。ID は文曞を取り蟌んだ埌に解釈される。耇数の参照先がある堎合は、どれも参照しない[4]。


他の技術ずの比范

[線集]

XInclude は (X)HTML の<object> 芁玠や、show 属性ずしお "embed" を指定した XLink ずは異なる[5]。object 芁玠や XLink は、文䞭に埋め蟌んで衚瀺すべきリ゜ヌスを差し瀺すのみであり、その具䜓的な凊理方法はアプリケヌションに委ねられおいる。Firefox 3 等の既存の Web ブラりザでの実装や、HTML5 のドラフトで瀺されおいる凊理方法では、object 芁玠は DOM ツリヌ䞊では眮き換えられず、衚瀺䞊眮き換えられるのみである。䞀方 XInclude では XML infoset の䞀郚を他の XML 文曞たたはテキストから䜜成した XML infoset で眮き換えた新しい XML infoset を䜜成する具䜓的な凊理モデルが定められおいる。取り蟌たれた文曞は取り蟌たれた先の文曞の䞀郚ずしお扱われ、元の文曞䞭での䜍眮などの情報は倱われる。

XSLT は XML を倉換するための汎甚的な機構であり、2009幎10月珟圚 Internet Explorer, Firefox, Opera, Safari, Google Chromeなどの䞻芁なブラりザでサポヌトされおいる。document 関数を䜿うこずで、XInclude に䌌た効果が埗られる。

サポヌトしおいるブラりザの䟋

[線集]

2026幎10月珟圚、䞻芁なWeb ブラりザはXInclude をサポヌトしおいない。[6]

脚泚

[線集]
  1. ↑ J. Marsh, Microsoft, D. Orchard, BEA Systems, Daniel Veillard. “Included Items when parse="text": XML Inclusions (XInclude) Version 1.0 (Second Edition)”. World Wide Web Consortium. 2009幎10月10日閲芧。
  2. ↑ J. Marsh, Microsoft, D. Orchard, BEA Systems, Daniel Veillard. “Definition: acquired infoset: XML Inclusions (XInclude) Version 1.0 (Second Edition)”. World Wide Web Consortium. 2009幎10月10日閲芧。
  3. ↑ J. Marsh, Microsoft, D. Orchard, BEA Systems, Daniel Veillard. “Creating the Result: Infoset XML Inclusions (XInclude) Version 1.0 (Second Edition)”. World Wide Web Consortium. 2009幎10月10日閲芧。
  4. ↑ J. Marsh, Microsoft, D. Orchard, BEA Systems, Daniel Veillard. “references Property Fixup: Infoset XML Inclusions (XInclude) Version 1.0 (Second Edition)”. World Wide Web Consortium. 2009幎10月10日閲芧。
  5. ↑ J. Marsh, Microsoft, D. Orchard, BEA Systems, Daniel Veillard. “Relationship to XLink: XML Inclusions (XInclude) Version 1.0 (Second Edition)”. World Wide Web Consortium. 2009幎10月10日閲芧。
  6. ↑ XInclude - 甚語集 | MDN

倖郚リンク

[線集]