XSL 変換 (XSLT) 1.0

2.1 XSLT 名前空間

XSLT 名前空間の URI は http://www.w3.org/1999/XSL/Transform である。 The XSLT namespace has the URI http://www.w3.org/1999/XSL/Transform.

注記： URI 内の 1999 は W3C がこの URI を割り当てた年度を示している。 この数字は利用する XSLT のバージョンを指示するものではない。 バージョンは属性により指定される（ [2.2 スタイルシートの要素], [2.3 スタイルシートとしてのリテラル結果要素] を見よ）。 NOTE:The 1999 in the URI indicates the year in which the URI was allocated by the W3C. It does not indicate the version of XSLT being used, which is specified by attributes (see [2.2 Stylesheet Element] and [2.3 Literal Result Element as Stylesheet]).

XSLT プロセッサは XML 名前空間の要素と属性の認識に際し, XML 名前空間の仕組み [XML Names] を利用しなければならない。 XSLT 名前空間の要素はスタイルシート内でのみ認識され、ソース文書内では認識されない。 XSLT で定義する要素の全一覧は [B 要素の構文の要約] で指定される。 ベンダは要素や属性を追加して XSLT 名前空間を拡張してはならない。 拡張を行う場所は XSLT 名前空間ではなく、別の名前空間内でなければならない。 命令用要素を追加する際に利用する名前空間は [14.1 拡張要素] で規定する拡張要素の仕組みにより識別できなければならない。 XSLT processors must use the XML namespaces mechanism [XML Names] to recognize elements and attributes from this namespace. Elements from the XSLT namespace are recognized only in the stylesheet and not in the source document. The complete list of XSLT-defined elements is specified in [B Element Syntax Summary]. Vendors must not extend the XSLT namespace with additional elements or attributes. Instead, any extension must be in a separate namespace. Any namespace that is used for additional instruction elements must be identified by means of the extension element mechanism specified in [14.1 Extension Elements].

この仕様においては XSLT 名前空間の要素を指す接頭辞に xsl: を用いることにする。 しかしながら, XSLT スタイルシートにおいては、名前空間宣言により XSLT 名前空間の URI に結びつけられているならば, どのような接頭辞が用いられてもよい。 This specification uses a prefix of xsl: for referring to elements in the XSLT namespace. However, XSLT stylesheets are free to use any prefix, provided that there is a namespace declaration that binds the prefix to the URI of the XSLT namespace.

XSLT 名前空間に属する要素は、 XSLT 名前空間に属さない任意の属性を, その 展開名 (expanded-name) の名前空間 URI が null でない限り, 持つことができる。 ただし、このような属性の存在から XSLT 要素やこの文書で定義する関数のふるまいが変更されてはならない。 従って, XSLT プロセッサはこのような属性をいつでも無視してよく、その名前空間 URI を認識できない場合は, エラーを生成せずにこれらの属性を無視しなければならない。 このような属性は、例えば 一意的な識別子, 最適化のヒント, 添付情報 などを供し得る。 An element from the XSLT namespace may have any attribute not from the XSLT namespace, provided that the expanded-name of the attribute has a non-null namespace URI. The presence of such attributes must not change the behavior of XSLT elements and functions defined in this document. Thus, an XSLT processor is always free to ignore such attributes, and must ignore such attributes without giving an error if it does not recognize the namespace URI. Such attributes can provide, for example, unique identifiers, optimization hints, or documentation.

XSLT 名前空間の要素に、この文書で要素に定義する属性以外の, 展開名の名前空間 URI が null になる属性（名前に接頭辞が無い属性）が含まれる場合、エラーとする。 It is an error for an element from the XSLT namespace to have attributes with expanded-names that have null namespace URIs (i.e. attributes with unprefixed names) other than attributes defined for the element in this document.

注記： XSLT の要素名, 属性名, 関数名 に関する表記慣行は、小文字のみ, 単語はハイフン区切り, 略語の利用は XML や HTML などの関連言語の構文内ですでに現れている場合のみ、とされている。 NOTE:The conventions used for the names of XSLT elements, attributes and functions are that names are all lower-case, use hyphens to separate words, and use abbreviations only if they already appear in the syntax of a related language such as XML or HTML.

2.2 スタイルシート要素

<xsl:stylesheet
  id = id 
  extension-element-prefixes = tokens 
  exclude-result-prefixes = tokens
         version = number>
  <!-- 内容：(xsl:import*, top-level-elements) -->
</xsl:stylesheet>

<xsl:transform
  id = id 
  extension-element-prefixes = tokens 
  exclude-result-prefixes = tokens
         version = number>
  <!-- 内容：(xsl:import*, top-level-elements) -->
</xsl:transform>

スタイルシートは XML 文書内の xsl:stylesheet 要素で表現される。 xsl:transform も xsl:stylesheet の同義語として許容される。 A stylesheet is represented by an xsl:stylesheet element in an XML document. xsl:transform is allowed as a synonym for xsl:stylesheet.

xsl:stylesheet 要素には、スタイルシートが要求する XSLT のバージョンを指示する version 属性が与えられていなければならない。 このバージョンの XSLT においては、属性値は 1.0 とすべきである。 この値が 1.0 以外の場合、前方互換処理モードが有効になる （ [2.5 前方互換処理] を見よ）。 An xsl:stylesheet element must have a version attribute, indicating the version of XSLT that the stylesheet requires. For this version of XSLT, the value should be 1.0. When the value is not equal to 1.0, forwards-compatible processing mode is enabled (see [2.5 Forwards-Compatible Processing]).

xsl:stylesheet 要素は、次の型の要素を含み得る。 The xsl:stylesheet element may contain the following types of elements:

• xsl:import
• xsl:include
• xsl:strip-space
• xsl:preserve-space
• xsl:output
• xsl:key
• xsl:decimal-format
• xsl:namespace-alias
• xsl:attribute-set
• xsl:variable
• xsl:param
• xsl:template

xsl:stylesheet 要素の子として現れる要素は トップレベル （ top-level ）要素と呼ばれる。 An element occurring as a child of an xsl:stylesheet element is called a top-level element.

次の例にスタイルシートの構造を示す。 省略記号（ ... ）は、属性値あるいは内容が省略されていることを表す。 この例では、利用可能な要素型をそれぞれ１個ずつ記述しているが、スタイルシートはこれらの要素それぞれについて、０個以上, いくつでも含み得る。 This example shows the structure of a stylesheet. Ellipses (...) indicate where attribute values or content have been omitted. Although this example shows one of each type of allowed element, stylesheets may contain zero or more of each of these elements.

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:import href="..."/>

  <xsl:include href="..."/>

  <xsl:strip-space elements="..."/>
  
  <xsl:preserve-space elements="..."/>

  <xsl:output method="..."/>

  <xsl:key name="..." match="..." use="..."/>

  <xsl:decimal-format name="..."/>

  <xsl:namespace-alias stylesheet-prefix="..." result-prefix="..."/>

  <xsl:attribute-set name="...">...</xsl:attribute-set>

  <xsl:variable name="...">...</xsl:variable>

  <xsl:param name="...">...</xsl:param>

  <xsl:template match="...">...</xsl:template>

  <xsl:template name="...">...</xsl:template>

</xsl:stylesheet>

xsl:stylesheet 要素の子の出現順序は、xsl:import 要素とエラー回復を除いて重要ではない。 スタイルシート作成者は要素を好みに合わせて自由に並べられる。 また、スタイルシート生成ツールも要素の出現順序の制御機能を提供する必要はない。 The order in which the children of the xsl:stylesheet element occur is not significant except for xsl:import elements and for error recovery. Users are free to order the elements as they prefer, and stylesheet creation tools need not provide control over the order in which the elements occur.

加えて, xsl:stylesheet 要素には、 XSLT 名前空間に属さない任意の要素も, その展開名が非 null の名前空間 URI を持つならば, 含められる。 このようなトップレベル要素が存在しても、この文書で定義された XSLT 要素と関数のふるまいが変更されてはならない。 例えば、競合解決のために異なるルールを利用する目的でトップレベル要素に xsl:apply-templates を指定することは許されない。 従って, XSLT プロセッサは、このようなトップレベル要素をいつでも無視してよく, その名前空間 URI を認識できない場合は、エラーを生成せずにこれらのトップレベル要素を無視しなければならない。 これらの要素は 例えば以下に挙げるデータを提供し得る。 In addition, the xsl:stylesheet element may contain any element not from the XSLT namespace, provided that the expanded-name of the element has a non-null namespace URI. The presence of such top-level elements must not change the behavior of XSLT elements and functions defined in this document; for example, it would not be permitted for such a top-level element to specify that xsl:apply-templates was to use different rules to resolve conflicts. Thus, an XSLT processor is always free to ignore such top-level elements, and must ignore a top-level element without giving an error if it does not recognize the namespace URI. Such elements can provide, for example,

• 拡張要素や拡張関数が利用する情報（ [14 拡張] を見よ） information used by extension elements or extension functions (see [14 Extensions]),

• 結果ツリーの処理に関する情報 information about what to do with the result tree,

• ソースツリーの取得方法に関する情報 information about how to obtain the source tree,

• スタイルシートに関するメタデータ metadata about the stylesheet,

• スタイルシートのための構造化された添付文書 structured documentation for the stylesheet.

2.3 スタイルシートとしてのリテラル結果要素

ルートノード用のテンプレート１個だけから構成されるスタイルシートのために、簡略化された構文が用意されている。 このスタイルシートは、リテラル結果要素のみから構成されていてもよい （ [7.1.1 リテラル結果要素] を見よ）。 このようなスタイルシートは、そのリテラル結果要素を含む、照合パターンが / のテンプレートルール１個だけからなる xsl:stylesheet 要素を含むスタイルシートと等価になる。 例を示す： A simplified syntax is allowed for stylesheets that consist of only a single template for the root node. The stylesheet may consist of just a literal result element (see [7.1.1 Literal Result Elements]). Such a stylesheet is equivalent to a stylesheet with an xsl:stylesheet element containing a template rule containing the literal result element; the template rule has a match pattern of /. For example

<html xsl:version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
      xmlns="http://www.w3.org/TR/xhtml1/strict">
  <head>
    <title>Expense Report Summary</title>
  </head>
  <body>
    <p>Total Amount: <xsl:value-of select="expense-report/total"/></p>
  </body>
</html>

これは次と同じ意味になる。 has the same meaning as

<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
      xmlns="http://www.w3.org/TR/xhtml1/strict">
<xsl:template match="/">
<html>
  <head>
    <title>Expense Report Summary</title>
  </head>
  <body>
    <p>Total Amount: <xsl:value-of select="expense-report/total"/></p>
  </body>
</html>
</xsl:template>
</xsl:stylesheet>

スタイルシートの文書要素になるリテラル結果要素には、スタイルシートに要求される XSLT のバージョンを指示する xsl:version 属性が指定されなければならない。 このバージョンの XSLT では、属性値は 1.0 にすべきである。 この値は Number でなければならない。 他のリテラル結果要素にも xsl:version 属性を指定できる。 xsl:version 属性の値が 1.0 以外の場合、前方互換 (forwards-compatible) 処理モードが有効になる（ [2.5 前方互換処理] を見よ）。 A literal result element that is the document element of a stylesheet must have an xsl:version attribute, which indicates the version of XSLT that the stylesheet requires. For this version of XSLT, the value should be 1.0; the value must be a Number. Other literal result elements may also have an xsl:version attribute. When the xsl:version attribute is not equal to 1.0, forwards-compatible processing mode is enabled (see [2.5 Forwards-Compatible Processing]).

スタイルシートとして用いるリテラル結果要素に許される内容は、リテラル結果要素をスタイルシート内で用いる場合と同様である。 従って、スタイルシートとして用いるリテラル結果要素の内容に トップレベル 要素を含めることはできない。 The allowed content of a literal result element when used as a stylesheet is no different from when it occurs within a stylesheet. Thus, a literal result element used as a stylesheet cannot contain top-level elements.

システム側が XML 文書を XSLT スタイルシートとして XSLT プロセッサに渡して処理させる必要があるかどうかを知る方法が XML 文書自体を調査するより無い状況もある。 簡略構文を用いた場合、この処理はより難しくなる。 In some situations, the only way that a system can recognize that an XML document needs to be processed by an XSLT processor as an XSLT stylesheet is by examining the XML document itself. Using the simplified syntax makes this harder.

注記： 例えば、別の XML 言語（ AXL とする）が、ある XML 文書に対し AXL プロセッサに処理させる必要がある AXL 文書であることを指示するために文書要素上に axl:version を与えている可能性がある。 同じ文書に axl:version 属性と xsl:version 属性の両者が含まれている場合、その文書を XSLT プロセッサと AXL プロセッサのどちらに処理させるべきか自明でなくなる。 NOTE:For example, another XML language (AXL) might also use an axl:version on the document element to indicate that an XML document was an AXL document that required processing by an AXL processor; if a document had both an axl:version attribute and an xsl:version attribute, it would be unclear whether the document should be processed by an XSLT processor or an AXL processor.

そのため、このような状況で利用され得る XSLT スタイルシートに簡略構文を用いるべきではない。 このような状況は、例えば XSLT スタイルシートが text/xml または application/xml の MIME メディア型を伴うメッセージとして、 MIME メディア型に基づいてメッセージの処理方法を決定する受信者側へ送信される際に生じる。 Therefore, the simplified syntax should not be used for XSLT stylesheets that may be used in such a situation. This situation can, for example, arise when an XSLT stylesheet is transmitted as a message with a MIME media type of text/xml or application/xml to a recipient that will use the MIME media type to determine how the message is processed.

2.4 修飾名

内部 XSLT オブジェクトの名前：特に、名前付きテンプレート（ [6 名前付きテンプレート] を見よ）, モード（ [5.7 モード] を見よ）, 属性集合（ [7.1.4 名前付き属性の集合] を見よ）, キー（ [12.2 キー] を見よ）, 十進フォーマット（ [12.3 数値のフォーマット] を見よ）, 変数, パラメタ（ [11 変数とパラメタ] ）の名前は、 QName 【"Qualified Name" - 修飾名】 により指定される。 名前に接頭辞がある場合、接頭辞はその名前が現れた属性に対し有効な名前空間宣言を用いて URI 参照に展開される。 名前の局所部と URI 参照（ null もあり得る）から構成される 展開名 （ expanded-name ）が、オブジェクトの名前として用いられる。 既定の名前空間は、接頭辞のない名前に用いられない。 The name of an internal XSLT object, specifically a named template (see [6 Named Templates]), a mode (see [5.7 Modes]), an attribute set (see [7.1.4 Named Attribute Sets]), a key (see [12.2 Keys]), a decimal-format (see [12.3 Number Formatting]), a variable or a parameter (see [11 Variables and Parameters]) is specified as a QName. If it has a prefix, then the prefix is expanded into a URI reference using the namespace declarations in effect on the attribute in which the name occurs. The expanded-name consisting of the local part of the name and the possibly null URI reference is used as the name of the object. The default namespace is not used for unprefixed names.

2.5 前方互換処理

xsl:stylesheet 要素の version 属性の値が 1.0 以外の場合、それ自身とその属性、およびすべての子孫とその属性に対し前方互換処理モードが有効になる。 ただし、リテラル結果要素が xsl:version 属性を持ち、その値が 1.0 の場合、それ自身とその属性、およびすべての子孫とその属性に対する前方互換処理モードは無効になる。 An element enables forwards-compatible mode for itself, its attributes, its descendants and their attributes if either it is an xsl:stylesheet element whose version attribute is not equal to 1.0 , or it is a literal result element that has an xsl:version attribute whose value is not equal to 1.0, or it is a literal result element that does not have an xsl:version attribute and that is the document element of a stylesheet using the simplified syntax (see [2.3 Literal Result Element as Stylesheet]). A literal result element that has an xsl:version attribute whose value is equal to 1.0 disables forwards-compatible mode for itself, its attributes, its descendants and their attributes.

前方互換処理モードによる要素の処理においては： If an element is processed in forwards-compatible mode, then:

• 処理対象が トップレベル 要素で、 XSLT 1.0 においてトップレベル要素として利用できない要素に対しては、その要素は内容も含めて無視されなければならない。 if it is a top-level element and XSLT 1.0 does not allow such elements as top-level elements, then the element must be ignored along with its content;

• 処理対象がテンプレート内の要素で、 XSLT 1.0 においてテンプレート内に現れてはならない要素に対しては、要素のインスタンス化を行わないのならエラーを通知してはならない。 要素のインスタンス化を行う場合、 [15 フォールバック] で述べる手順により要素のフォールバック（代替）が実行されなければならない。 if it is an element in a template and XSLT 1.0 does not allow such elements to occur in templates, then if the element is not instantiated, an error must not be signaled, and if the element is instantiated, the XSLT must perform fallback for the element as specified in [15 Fallback];

• 処理対象の要素が XSLT 1.0 で許容されない属性を持つ場合、または XSLT 1.0 では許容されない値をとるオプションの属性を持つ場合、その属性は無視されなければならない。 if the element has an attribute that XSLT 1.0 does not allow the element to have or if the element has an optional attribute with a value that the XSLT 1.0 does not allow the attribute to have, then the attribute must be ignored.

従って, 次のスタイルシートには, この仕様で定義していない XSLT 名前空間の要素が含まれているが、 XSLT 1.0 プロセッサは、このスタイルシートをエラーを生じさせずに処理できなければならない。 Thus, any XSLT 1.0 processor must be able to process the following stylesheet without error, although the stylesheet includes elements from the XSLT namespace that are not defined in this specification:

<xsl:stylesheet version="1.1"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:template match="/">
    <xsl:choose>
      <xsl:when test="system-property('xsl:version') >= 1.1">
        <xsl:exciting-new-1.1-feature/>
      </xsl:when>
      <xsl:otherwise>
        <html>
        <head>
          <title>XSLT 1.1 required</title>
        </head>
        <body>
          <p>Sorry, this stylesheet requires XSLT 1.1.</p>
        </body>
        </html>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
</xsl:stylesheet>

注記： スタイルシートが、 1.0 より後のバージョンの XSLT に導入されたトップレベル要素に決定的に依存するような場合、そのスタイルシートに terminate="yes" を伴う xsl:message 要素を用いることにより（ [13 メッセージ] を見よ）, 前のバージョンの XSLT を実装する XSLT プロセッサがそのトップレベル要素を黙って無視しないようにさせられる。 例を示す： NOTE:If a stylesheet depends crucially on a top-level element introduced by a version of XSLT after 1.0, then the stylesheet can use an xsl:message element with terminate="yes" (see [13 Messages]) to ensure that XSLT processors implementing earlier versions of XSLT will not silently ignore the top-level element. For example,

<xsl:stylesheet version="1.5"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:important-new-1.1-declaration/>

  <xsl:template match="/">
    <xsl:choose>
      <xsl:when test="system-property('xsl:version') &lt; 1.1">
        <xsl:message terminate="yes">
          <xsl:text>Sorry, this stylesheet requires XSLT 1.1.</xsl:text>
        </xsl:message>
      </xsl:when>
      <xsl:otherwise>
        ...
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
  ...
</xsl:stylesheet>

前方互換モードで処理される属性に現れる 式 からエラーが生じた場合、 XSLT プロセッサは次のようにエラーを回復しなければならない： If an expression occurs in an attribute that is processed in forwards-compatible mode, then an XSLT processor must recover from errors in the expression as follows:

• その式が XPath の文法で許容される構文に一致しない場合、その式が実際に評価されない限り, エラーを通知してはならない。 if the expression does not match the syntax allowed by the XPath grammar, then an error must not be signaled unless the expression is actually evaluated;

• その式が XSLT ライブラリに属さない接頭辞のない名前の関数を呼び出す場合、その関数が実際に呼び出されない限り, エラーを通知してはならない。 if the expression calls a function with an unprefixed name that is not part of the XSLT library, then an error must not be signaled unless the function is actually called;

• その式による関数呼び出しにおいて引数の個数または引数の型が XSLT で許容されないものだった場合、その関数が実際に呼び出されない限り, エラーを通知してはならない。 if the expression calls a function with a number of arguments that XSLT does not allow or with arguments of types that XSLT does not allow, then an error must not be signaled unless the function is actually called.

2.6 スタイルシートの結合

XSLT には、スタイルシートを結合する２種類の仕組みがある。 XSLT provides two mechanisms to combine stylesheets:

• 結合されるスタイルシートの意味内容を変更せずに、スタイルシートの結合を可能にするインクルードの仕組み。 an inclusion mechanism that allows stylesheets to be combined without changing the semantics of the stylesheets being combined, and

• スタイルシート間で相互の上書きを可能にするインポートの仕組み。 an import mechanism that allows stylesheets to override each other.

<!-- 分類：top-level-element -->
<xsl:include
  href = uri-reference />

<xsl:import
  href = uri-reference />

<xsl:stylesheet version="1.0"
          xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:import href="article.xsl"/>
  <xsl:import href="bigfont.xsl"/>
  <xsl:attribute-set name="note-style">
    <xsl:attribute name="font-style">italic</xsl:attribute>
  </xsl:attribute-set>
</xsl:stylesheet>

2.7 スタイルシートの埋め込み

通常, XSLT スタイルシートは、 xsl:stylesheet 要素を文書要素として持つ完全な XML 文書である。 しかしながら、他のリソースに XSLT スタイルシートを埋め込むこともできる。 スタイルシートの埋め込みには次の２つの形式がある： Normally an XSLT stylesheet is a complete XML document with the xsl:stylesheet element as the document element. However, an XSLT stylesheet may also be embedded in another resource. Two forms of embedding are possible:

• XSLT スタイルシートが XML 以外のリソースにテキストのままの状態で埋め込まれる形式。 または、 the XSLT stylesheet may be textually embedded in a non-XML resource, or

• xsl:stylesheet 要素が、文書要素以外の形で XML 文書内に現れる形式。 the xsl:stylesheet element may occur in an XML document other than as the document element.

２つ目の形式による埋め込みを容易にするため、 xsl:stylesheet 要素には、一意的な識別子を指定する ID 型の属性が許容されている。 To facilitate the second form of embedding, the xsl:stylesheet element is allowed to have an ID attribute that specifies a unique identifier.

注記： このような ID 型の属性を XPath の id 関数と伴に利用できるようにするためには、この属性が ID 型として DTD 内で実際に宣言されていなければならない。 NOTE:In order for such an attribute to be used with the XPath id function, it must actually be declared in the DTD as being an ID.

下に、文書に独自のスタイルシートを含められるようにする処理命令 xml-stylesheet [XML Stylesheet] の用例を示す。 URI 参照には xsl:stylesheet 要素の位置を特定する素片識別子が付加された相対 URI が用いられる。 The following example shows how the xml-stylesheet processing instruction [XML Stylesheet] can be used to allow a document to contain its own stylesheet. The URI reference uses a relative URI with a fragment identifier to locate the xsl:stylesheet element:

<?xml-stylesheet type="text/xml" href="#style1"?>
<!DOCTYPE doc SYSTEM "doc.dtd">
<doc>
<head>
<xsl:stylesheet id="style1"
        version="1.0"
        xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
        xmlns:fo="http://www.w3.org/1999/XSL/Format">
<xsl:import href="doc.xsl"/>
<xsl:template match="id('foo')">
  <fo:block font-weight="bold"><xsl:apply-templates/></fo:block>
</xsl:template>
<xsl:template match="xsl:stylesheet">
  <!-- ignore -->
</xsl:template>
</xsl:stylesheet>
</head>
<body>
<para id="foo">
...
</para>
</body>
</doc>

注記： 文書に文書自身を適用対象にするスタイルシートを埋め込む場合、またはそのようなスタイルシートからインクルードあるいはインポートされ得るスタイルシートには、通常, xsl:stylesheet 要素が無視されるようなテンプレートルールを含めておく必要がある。 NOTE:A stylesheet that is embedded in the document to which it is to be applied or that may be included or imported into a stylesheet that is so embedded typically needs to contain a template rule that specifies that xsl:stylesheet elements are to be ignored.

3.1 ルートノードの子

ルートノードの子に関する通常時の制約は、結果ツリーにおいては緩和される。 結果ツリーは、要素ノードに可能な任意のノードの並びを子として持ち得る。 特に、結果ツリーには任意の子テキストノードや任意個数の子要素ノードを含められる。 XML 出力メソッド（ [16 出力] を見よ）を用いて書き出される場合、結果ツリーが整形式 XML 文書にならない可能性もあるが、その場合でも, 結果ツリーは常に整形式の外部一般解析対象実体になる。 The normal restrictions on the children of the root node are relaxed for the result tree. The result tree may have any sequence of nodes as children that would be possible for an element node. In particular, it may have text node children, and any number of element node children. When written out using the XML output method (see [16 Output]), it is possible that a result tree will not be a well-formed XML document; however, it will always be a well-formed external general parsed entity.

整形式 XML 文書の構文解析により生成される, ソースツリーのルートノードは、子テキストノードを持たず, 子要素を１個だけ持つ という通常時の制約を自動的に満たす。 DOM の利用など、ソースツリーが他の方法から生成される場合、結果ツリーの場合と同様に, ソースツリーに対しても通常時の制約が緩和される。 When the source tree is created by parsing a well-formed XML document, the root node of the source tree will automatically satisfy the normal restrictions of having no text node children and exactly one element child. When the source tree is created in some other way, for example by using the DOM, the usual restrictions are relaxed for the source tree as for the result tree.

3.2 基底 URI

各ノードには基底 URI と呼ばれる URI が結びつけられる。 基底 URI は属性値の相対 URI を絶対 URI に解決するために利用される。 要素または処理命令が外部実体に現れた場合、その要素や処理命令の基底 URI は、その外部実体の URI になる。 他の場合、文書の基底 URI が基底 URI になる。 文書ノードの基底 URI は文書実体の URI になる。 テキストノード, コメントノード, 属性ノード, 名前空間ノードの基底 URI は、各ノードの親の基底 URI になる。 Every node also has an associated URI called its base URI, which is used for resolving attribute values that represent relative URIs into absolute URIs. If an element or processing instruction occurs in an external entity, the base URI of that element or processing instruction is the URI of the external entity; otherwise, the base URI is the base URI of the document. The base URI of the document node is the URI of the document entity. The base URI for a text node, a comment node, an attribute node or a namespace node is the base URI of the parent of the node.

3.3 解析対象外実体

ルートノードは、文書の DTD で宣言された解析対象外実体のそれぞれを URI に対応付ける情報を持つ。 URI は実体宣言内で指定されたシステム識別子および公開識別子から生成される。 XSLT プロセッサは、システム識別子に指定された URI の代わりに、公開識別子を用いて実体の URI を生成してもよい。 XSLT プロセッサは、 URI 生成に公開識別子を利用しない場合、システム識別子を利用しなければならない。 システム識別子が相対 URI だった場合、実体宣言を含むリソースの URI を基底 URI [RFC2396] として、相対 URI を絶対 URI に解決しなければならない。 The root node has a mapping that gives the URI for each unparsed entity declared in the document's DTD. The URI is generated from the system identifier and public identifier specified in the entity declaration. The XSLT processor may use the public identifier to generate a URI for the entity instead of the URI specified in the system identifier. If the XSLT processor does not use the public identifier to generate the URI, it must use the system identifier; if the system identifier is a relative URI, it must be resolved into an absolute URI using the URI of the resource containing the entity declaration as the base URI [RFC2396].

3.4 空白の削除

ソース文書やスタイルシート文書のツリーが構築された後、 XSLT により他の処理が行われる前に、一部のテキストノードは削除される。 削除され得るテキストノードは空白文字のみからなるものに限られる。 削除されるテキストノードはツリーから取り除かれる。 削除処理においては、空白が保持されなければならない要素名の集合（以下、「空白保持要素名の集合」）が入力に与えられる。 削除処理はスタイルシートとソース文書の両方に適用されるが、空白保持要素名の集合は、スタイルシートとソース文書のそれぞれについて別々に決定される。 After the tree for a source document or stylesheet document has been constructed, but before it is otherwise processed by XSLT, some text nodes are stripped. A text node is never stripped unless it contains only whitespace characters. Stripping the text node removes the text node from the tree. The stripping process takes as input a set of element names for which whitespace must be preserved. The stripping process is applied to both stylesheets and source documents, but the set of whitespace-preserving element names is determined differently for stylesheets and for source documents.

下記のいずれかに該当するテキストノードのみが保持される。 A text node is preserved if any of the following apply:

• テキストノードの親の要素名が、空白保持要素名の集合に含まれる。 The element name of the parent of the text node is in the set of whitespace-preserving element names.

• テキストノードに空白以外の文字が１個以上含まれている。 XML における空白文字は #x20, #x9, #xD, #xA である。 The text node contains at least one non-whitespace character. As in XML, a whitespace character is #x20, #x9, #xD or #xA.

• テキストノードの先祖要素の中で xml:space 属性が与えられたものがあり、それらのうち最も近い先祖の xml:space 属性の値が preserve である。 An ancestor element of the text node has an xml:space attribute with a value of preserve, and no closer ancestor element has xml:space with a value of default.

これら以外のテキストノードは削除される。 Otherwise, the text node is stripped.

xml:space 属性はツリーから削除されない。 The xml:space attributes are not stripped from the tree.

注記： これにより、リテラル結果要素に指定された xml:space 属性は結果にも含まれることになる。 NOTE:This implies that if an xml:space attribute is specified on a literal result element, it will be included in the result.

スタイルシートに対する空白保持要素名の集合は xsl:text のみからなる。 For stylesheets, the set of whitespace-preserving element names consists of just xsl:text.

<!-- 分類：top-level-element -->
<xsl:strip-space
  elements = tokens />

<!-- 分類：top-level-element -->
<xsl:preserve-space
  elements = tokens />

ソース文書に対する空白保持要素名の集合は トップレベル 要素の xsl:strip-space と xsl:preserve-space により指定される。 要素名が空白保持要素名の集合に入るかどうかは xsl:strip-space 要素または xsl:preserve-space 要素の中で「最適に合致」するものから定まる： 合致するものが存在しない, または xsl:preserve-space 要素の中で最適に合致するときに限り、要素名は空白保持要素名の集合に入るものとする。 これらの xsl:strip-space 要素と xsl:preserve-space 要素はそれぞれ、空白区切りの NameTest のリストを値にとる elements 属性を持つ。 要素名はいずれかの NameTest に合致するときに限り、 xsl:strip-space または xsl:preserve-space 要素に合致するものとする。 要素は XPath のノードテスト により NameTest が真と評価されるときに限り、 NameTest に合致するものとする。 複数の xsl:strip-space や xsl:preserve-space 要素に合致する場合、最適な合致は NameTest に最適に合致するものから決定されるものとする。 この決定はテンプレートルールの場合と同じ方法で解決される： For source documents, the set of whitespace-preserving element names is specified by xsl:strip-space and xsl:preserve-spacetop-level elements. These elements each have an elements attribute whose value is a whitespace-separated list of NameTests. Initially, the set of whitespace-preserving element names contains all element names. If an element name matches a NameTest in an xsl:strip-space element, then it is removed from the set of whitespace-preserving element names. If an element name matches a NameTest in an xsl:preserve-space element, then it is added to the set of whitespace-preserving element names. An element matches a NameTest if and only if the NameTest would be true for the element as an XPath node test. Conflicts between matches to xsl:strip-space and xsl:preserve-space elements are resolved the same way as conflicts between template rules (see [5.5 Conflict Resolution for Template Rules]). Thus, the applicable match for a particular element name is determined as follows: Whether an element name is included in the set of whitespace-preserving names is determined by the best match amongst xsl:strip-space or xsl:preserve-space elements: it is included if and only if there is no match or the best match is an xsl:preserve-space element. These The xsl:strip-space and xsl:preserve-space elements each have an elements attribute whose value is a whitespace-separated list of NameTests; an element name matches an xsl:strip-space or xsl:preserve-space element if it matches one of the NameTests. An element matches a NameTest if and only if the NameTest would be true for the element as an XPath node test. When more than one xsl:strip-space and xsl:preserve-space element matches, the best matching element is determined by the best matching NameTest. This is determined in the same way as with template rules:

• まず、他の合致より インポート優先順位 が低い合致は無視される。 First, any match with lower import precedence than another match is ignored.

• 次に、合致の 既定の優先度 が、他の合致の 既定の優先度 より低いものは無視される。 Next, any match with a NameTest that has a lower default priority than the default priority of the NameTest of another match is ignored.

この判定後にも複数の合致が残る場合、エラーとする。 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、判定後に残った合致からスタイルシートの最後方に現れるものを選択し, エラーから回復しなければならない。 It is an error if this leaves more than one match. An XSLT processor may signal the error; if it does not signal the error, it must recover by choosing, from amongst the matches that are left, the one that occurs last in the stylesheet.

5.1 処理モデル

結果ツリー素片を生成するため、ソースノードのリストが処理される。 結果ツリーは、ルートノードのみを含むリストの処理から構築される。 ソースノードのリストは、リスト内の各ノードを順に処理して生成された結果を, ツリー構造に追加していく形で処理される。 それぞれのノードの処理は、すべてのテンプレートルールからそのノードに合致するパターンを持つものを検索し, その中から最適なテンプレートルールを選択する所から始められる。 選択されたルールのテンプレートは、ノードを 現在のノード に, ソースノードのリストを 現在のノードリスト に設定して、インスタンス化が行われる。 通常、テンプレートには処理の対象になる追加のソースノードのリストを選択する命令が含まれている。 この 合致照合, インスタンス化, 選択の処理行程 が、処理対象として新たに選択されるソースノードがついえるまで再帰的に続けられる。 A list of source nodes is processed to create a result tree fragment. The result tree is constructed by processing a list containing just the root node. A list of source nodes is processed by appending the result tree structure created by processing each of the members of the list in order. A node is processed by finding all the template rules with patterns that match the node, and choosing the best amongst them; the chosen rule's template is then instantiated with the node as the current node and with the list of source nodes as the current node list. A template typically contains instructions that select an additional list of source nodes for processing. The process of matching, instantiation and selection is continued recursively until no new source nodes are selected for processing.

この処理モデルによる結果と同じ処理結果が得られるならば、実装はどのようにソース文書を処理してもよい。 Implementations are free to process the source document in any way that produces the same result as if it were processed using this processing model.

5.2 パターン

テンプレートルールは、 パターン を用いて適用先のノードを選別する。 パターンは、テンプレートルールのみならず, 番号付け （ [7.7 番号付け] を見よ）やキー宣言（ [12.2 キー] を見よ）にも利用される。 パターンはノードに対する条件の集合を指定する。 その条件すべてを満たすノードがそのパターンに合致するノードであり, 満たさないノードがそのパターンに合致しないノードとなる。 パターンの構文は、式の構文のサブセットである。 特に, 一定の制約を満たすロケーションパスは、パターンとしても利用できる。 パターンとしても利用可能な式は、常に, 評価結果がノード集合型のオブジェクトになる。 ノードがパターンに合致するのは、何らかの可能な文脈の下でパターンを式として評価した結果のノード集合に そのノードが属するときである。 可能な文脈とは、その文脈ノードが照合対象のノードそのものか, またはその先祖ノードの一つになるものを指す。 Template rules identify the nodes to which they apply by using a pattern. As well as being used in template rules, patterns are used for numbering (see [7.7 Numbering]) and for declaring keys (see [12.2 Keys]). A pattern specifies a set of conditions on a node. A node that satisfies the conditions matches the pattern; a node that does not satisfy the conditions does not match the pattern. The syntax for patterns is a subset of the syntax for expressions. In particular, location paths that meet certain restrictions can be used as patterns. An expression that is also a pattern always evaluates to an object of type node-set. A node matches a pattern if the node is a member of the result of evaluating the pattern as an expression with respect to some possible context; the possible contexts are those whose context node is the node being matched or one of its ancestors.

以下にパターンの例を示す。 Here are some examples of patterns:

• para はすべての para 要素に合致する。 para matches any para element

• * は、すべての要素に合致する。 * matches any element

• chapter|appendix は、すべての chapter 要素と, すべての appendix 要素に合致する。 chapter|appendix matches any chapter element and any appendix element

• olist/item は、親が olist 要素になる, すべての item 要素に合致する。 olist/item matches any item element with an olist parent

• appendix//para は、先祖要素に appendix を持つ, すべての para 要素に合致する。 appendix//para matches any para element with an appendix ancestor element

• / は、ルートノードに合致する。 / matches the root node

• text() は、すべてのテキストノードに合致する。 text() matches any text node

• processing-instruction() は、すべての処理命令に合致する。 processing-instruction() matches any processing instruction

• node() は、属性ノードとルートノードを除く, すべてのノードに合致する。 node() matches any node other than an attribute node and the root node

• id("W11") は、一意 ID として W11 を持つ要素に合致する。 id("W11") matches the element with unique ID W11

• para[1] は、 para 要素であって, 親に対し最初の para 子要素になるような, すべての要素に合致する。 【同胞の para 要素の中で最初のもの】 para[1] matches any para element that is the first para child element of its parent

• *[position()=1 and self::para] は、要素であって, 親に対し最初の子要素になるような, すべての para 要素に合致する。 【同胞の要素の中で最初のものになる para 要素】 *[position()=1 and self::para] matches any para element that is the first child element of its parent

• para[last()=1] は、 para 要素であって, 親に対して唯一の para 子要素になるような, すべての要素に合致する。 【同胞の para 要素が自身のみになるもの】 para[last()=1] matches any para element that is the only para child element of its parent

• items/item[position()>1] は、 items 要素を親に持つ item 要素であって, 親に対し最初の item 子要素にはならないような, すべての要素に合致する。 items/item[position()>1] matches any item element that has an items parent and that is not the first item child of its parent

• item[position() mod 2 = 1] は、 item 要素であって, 親に対し奇数番目の item 子要素になるような, すべての要素に合致する。 【同胞の item 要素の中で奇数番目のもの】 item[position() mod 2 = 1] would be true for any item element that is an odd-numbered item child of its parent.

• div[@class="appendix"]//p は、値 appendix の class 属性を持つ div 要素を先祖に持つような, すべての p 要素に合致する。 div[@class="appendix"]//p matches any p element with a div ancestor element that has a class attribute with value appendix

• @class は、すべての class 属性に合致する（ class 属性を持つ要素のことではない）。 @class matches any class attribute (not any element that has a class attribute)

• @* は、すべての属性に合致する。 @* matches any attribute

パターンは Pattern の構文に一致しなければならない。 Pattern は、 | 区切りのロケーションパスパターンの集合である。 ロケーションパスパターンとは、すべてのステップに child 軸または attribute 軸のみを利用するロケーションパスである。 パターンでは descendant-or-self 軸を利用してはならないが、演算子 / と同様に演算子 // を利用してもよい。 ロケーションパスパターンは、リテラル引数による id 関数や key 関数の呼び出しからも始められる。 パターンの述語には、ロケーションパスの述語と同じく、任意の式を利用できる。 A pattern must match the grammar for Pattern. A Pattern is a set of location path patterns separated by |. A location path pattern is a location path whose steps all use only the child or attribute axes. Although patterns must not use the descendant-or-self axis, patterns may use the // operator as well as the / operator. Location path patterns can also start with an id or key function call with a literal argument. Predicates in a pattern can use arbitrary expressions just like predicates in a location path.

パターンがノードに合致するとは、ある「可能な」文脈の下でパターンが式として評価された結果のノード集合にノードが属するとき、と定義される。 ノードが照合される際の可能な文脈とは、文脈ノードが照合対象のノードまたはそのノードの先祖であり, かつ 文脈ノードリストがその文脈ノードのみからなる文脈とする。 A pattern is defined to match a node if and only if there is possible context such that when the pattern is evaluated as an expression with that context, the node is a member of the resulting node-set. When a node is being matched, the possible contexts have a context node that is the node being matched or any ancestor of that node, and a context node list containing just the context node.

例えば p がすべての p 要素に合致するのは、どの p であれ, p 要素の親を文脈ノードとして式 p を評価したとき、結果のノード集合に p 要素が含まれるからである。 For example, p matches any p element, because for any p if the expression p is evaluated with the parent of the p element as context the resulting node-set will contain that p element as one of its members.

注記： このことは、 p 要素が文書要素であっても, 文書のルートが文書要素の親になるので成立する。 NOTE:This matches even a p element that is the document element, since the document root is the parent of the document element.

パターンの意味内容は式の評価に基づいて間接的に指定されるが、パターンの意味は式の評価の視点で考えなくとも直接的に容易に理解できる。 パターンにおいて | は選択肢を示す。 １個以上の | で区切られた選択肢を持つパターンは、選択肢のいずれかが合致するとき, パターンとして合致する。 パターンが / または // で区切られた一連の StepPattern で構成されている場合、パターンの照合は右から左へ順に行われる。 パターンが合致するのは、右端の StepPattern が合致し, 残りのパターンにも合致する「適切な」要素が存在するときになる。 区切りが / の場合、親のみが適切な要素になる。 区切りが // の場合、すべての先祖が適切な要素になる。 child 軸を利用する StepPattern がノードに合致するのは、ノードに対する NodeTest が真であり, かつ そのノードが属性ノードでないときになる。 attribute 軸を利用する StepPattern がノードに合致するのは、ノードに対する NodeTest が真であり, かつ そのノードが属性ノードのときになる。 述語 [] がある場合、照合されるノードが属性ノードでないならば, そのノードを文脈ノードとし、その同胞ノードのうち NodeTest に合致するものを文脈ノードリストとして, StepPattern の最初の PredicateExpr が評価される。 照合されるノードが属性ノードの場合の文脈ノードリストは、 NodeTest に合致する同胞属性（同じ親を持つ属性）のうち, NodeTest に合致するものからなるとする。 Although the semantics of patterns are specified indirectly in terms of expression evaluation, it is easy to understand the meaning of a pattern directly without thinking in terms of expression evaluation. In a pattern, | indicates alternatives; a pattern with one or more | separated alternatives matches if any one of the alternative matches. A pattern that consists of a sequence of StepPatterns separated by / or // is matched from right to left. The pattern only matches if the rightmost StepPattern matches and a suitable element matches the rest of the pattern; if the separator is / then only the parent is a suitable element; if the separator is //, then any ancestor is a suitable element. A StepPattern that uses the child axis matches if the NodeTest is true for the node and the node is not an attribute node. A StepPattern that uses the attribute axis matches if the NodeTest is true for the node and the node is an attribute node. When [] is present, then the first PredicateExpr in a StepPattern is evaluated with the node being matched as the context node and the siblings of the context node that match the NodeTest as the context node list, unless the node being matched is an attribute node, in which case the context node list is all the attributes that have the same parent as the attribute being matched and that match the NameTest.

例えば For example

appendix//ulist/item[position()=1]

は、次に挙げる条件がすべて真となる場合にのみ、ノードに合致する。 matches a node if and only if all of the following are true:

• NodeTest item がそのノードに対して真であり, そのノードが属性ではない。 すなわち、ノードが item 要素である。 the NodeTest item is true for the node and the node is not an attribute; in other words the node is an item element

• そのノードを文脈ノードとし, そのノードの同胞の item 要素を文脈ノードリストとして PredicateExpr position()=1 を評価したときに真になる。 evaluating the PredicateExpr position()=1 with the node as context node and the siblings of the node that are item elements as the context node list yields true

• そのノードが appendix//ulist に合致する親を持つ。 これは、その親が先祖要素に appendix を持つ ulist 要素のとき真になる。 the node has a parent that matches appendix//ulist; this will be true if the parent is a ulist element that has an appendix ancestor element.

5.3 テンプレートルールの定義

<!-- 分類：top-level-element -->
<xsl:template
  match = pattern 
  name = qname 
  priority = number 
  mode = qname>
  <!-- 内容：(xsl:param*, template) -->
</xsl:template>

テンプレートルールは、xsl:template 要素を用いて指定される。 match 属性がソースノードやルールの適用先ノードを選別する Pattern を与える。 match 属性は xsl:template 要素が name 属性を持つ場合を除き, 必須になる（ [6 名前付きテンプレート] を見よ）。 match 属性の値が VariableReference を含む場合、エラーとする。 xsl:template 要素の内容が、テンプレートルールが適用されるときにインスタンス化されるテンプレートである。 A template rule is specified with the xsl:template element. The match attribute is a Pattern that identifies the source node or nodes to which the rule applies. The match attribute is required unless the xsl:template element has a name attribute (see [6 Named Templates]). It is an error for the value of the match attribute to contain a VariableReference. The content of the xsl:template element is the template that is instantiated when the template rule is applied.

例えば XML 文書が次を含むとする： For example, an XML document might contain:

This is an <emph>important</emph> point.

次のテンプレートルールは、上の emph 要素に合致し, font-weight プロパティが bold のフォーマッティングオブジェクト fo:inline-sequence を生成する。 The following template rule matches emph elements and produces a fo:inline-sequence formatting object with a font-weight property of bold.

<xsl:template match="emph">
  <fo:inline-sequence font-weight="bold">
    <xsl:apply-templates/>
  </fo:inline-sequence>
</xsl:template>

注記： この仕様の記述例では、接頭辞 fo: を [XSL] が定めるフォーマット化オブジェクトの名前空間 http://www.w3.org/1999/XSL/Format に利用する。 NOTE:Examples in this document use the fo: prefix for the namespace http://www.w3.org/1999/XSL/Format, which is the namespace of the formatting objects defined in [XSL].

次節で述べるように xsl:apply-templates 要素はソース要素の子を再帰的に処理する。 As described next, the xsl:apply-templates element recursively processes the children of the source element.

5.4 テンプレートルールの適用

<!-- 分類：instruction -->
<xsl:apply-templates
  select = node-set-expression 
  mode = qname>
  <!-- 内容：(xsl:sort | xsl:with-param)* -->
</xsl:apply-templates>

次の例は chapter 要素に対し fo:block を生成し、次にその chapter 要素の直下の子を処理する。 This example creates a block for a chapter element and then processes its immediate children.

<xsl:template match="chapter">
  <fo:block>
    <xsl:apply-templates/>
  </fo:block>
</xsl:template>

xsl:apply-templates 命令は、 select 属性が与えられていなければ, テキストノードを含む現在のノードのすべての子ノードを処理する。 ただし、 [3.4 空白の削除] に則って削除されるテキストノードは処理しない。 空白保持要素名の集合に含まれない要素に対しては、要素の内容に含まれるすべての空白がテキストとして処理される。 従って, 子要素に挟まれる空白も、 position 関数から子要素の位置を決定する際にカウントされる。 In the absence of a select attribute, the xsl:apply-templates instruction processes all of the children of the current node, including text nodes. However, text nodes that have been stripped as specified in [3.4 Whitespace Stripping] will not be processed. If stripping of whitespace nodes has not been enabled for an element, then all whitespace in the content of the element will be processed as text, and thus whitespace between child elements will count in determining the position of a child element as returned by the position function.

select 属性を利用すると、すべての子を処理する代わりに, 式により選別したノードだけを処理できる。 select 属性の値は 式 である。 式の評価結果はノード集合でなければならない。 選択されたノード集合は、ソート（ [10 ソート] を見よ）が指定されていなければ, 文書順に処理される。 次の例は author-group の子の author すべてを処理する。 A select attribute can be used to process nodes selected by an expression instead of processing all children. The value of the select attribute is an expression. The expression must evaluate to a node-set. The selected set of nodes is processed in document order, unless a sorting specification is present (see [10 Sorting]). The following example processes all of the author children of the author-group:

<xsl:template match="author-group">
  <fo:inline-sequence>
    <xsl:apply-templates select="author"/>
  </fo:inline-sequence>
</xsl:template>

次の例は、 author-group の子の author すべてに対し、その子の given-name すべてを処理する。 The following example processes all of the given-names of the authors that are children of author-group:

<xsl:template match="author-group">
  <fo:inline-sequence>
    <xsl:apply-templates select="author/given-name"/>
  </fo:inline-sequence>
</xsl:template>

次の例は、book 要素のすべての子孫 heading 要素を処理する。 This example processes all of the heading descendant elements of the book element.

<xsl:template match="book">
  <fo:block>
    <xsl:apply-templates select=".//heading"/>
  </fo:block>
</xsl:template>

現在のノードの子孫でない要素も処理できる。 次の例では department 要素が子要素 group および子孫要素 employee を持つものと仮定する。 「従業員」（ employee ）の「部署」（ department ）を見つけ、次に department の子の group を処理する。 It is also possible to process elements that are not descendants of the current node. This example assumes that a department element has group children and employee descendants. It finds an employee's department and then processes the group children of the department.

<xsl:template match="employee">
  <fo:block>
    Employee <xsl:apply-templates select="name"/> belongs to group
    <xsl:apply-templates select="ancestor::department/group"/>
  </fo:block>
</xsl:template>

複数の xsl:apply-templates 要素を一つのテンプレート内で利用すると、簡単な再順序付けも行える。 次の例は、２つの HTML テーブルを作成する。 最初のテーブルには「国内販売高」（ domestic sales ）, 次のテーブルには「海外販売高」（ foreign sales ）のデータを挿入する。 Multiple xsl:apply-templates elements can be used within a single template to do simple reordering. The following example creates two HTML tables. The first table is filled with domestic sales while the second table is filled with foreign sales.

<xsl:template match="product">
  <table>
    <xsl:apply-templates select="sales/domestic"/>
  </table>
  <table>
    <xsl:apply-templates select="sales/foreign"/>
  </table>
</xsl:template>

注記： 一方が他方の子孫になっているような２つの子孫が合致することもあり得る。 この場合も特別には扱われず、両者とも通常どおり処理される。 例えば次のソース文書： NOTE: It is possible for there to be two matching descendants where one is a descendant of the other. This case is not treated specially: both descendants will be processed as usual. For example, given a source document

<doc><div><div></div></div></doc>

に対し、ルール： the rule

<xsl:template match="doc">
  <xsl:apply-templates select=".//div"/>
</xsl:template>

は、外側の div 要素と内側の div 要素の両方を処理する。 will process both the outer div and inner div elements.

注記： 通常、 xsl:apply-templates は現在のノードの子孫のノードのみを処理する目的に利用される。 そのような利用では、無限処理ループ（無限再帰）は生じない。 xsl:apply-templates を現在のノードの子孫でない要素の処理に利用した場合、終端のない処理ループが生じ得る。 例えば NOTE:Typically, xsl:apply-templates is used to process only nodes that are descendants of the current node. Such use of xsl:apply-templates cannot result in non-terminating processing loops. However, when xsl:apply-templates is used to process elements that are not descendants of the current node, the possibility arises of non-terminating loops. For example,

<xsl:template match="foo">
  <xsl:apply-templates select="."/>
</xsl:template>

実装側がこのようなループを検知できる場合もあるが、検知できない無限ループに陥る可能性もある。 これは、サービスの安全性を侵すリスクになり得る。 Implementations may be able to detect such loops in some cases, but the possibility exists that a stylesheet may enter a non-terminating loop that an implementation is unable to detect. This may present a denial of service security risk.

5.5 テンプレートルールの競合解決

１個のソースノードが、複数のテンプレートに合致することがある。 利用されるテンプレートルールは以下の手順で決定される： It is possible for a source node to match more than one template rule. The template rule to be used is determined as follows:

1. 最初に、合致するテンプレートルールの中で インポート優先順位 が最高でないものはすべて候補から外す。 First, all matching template rules that have lower import precedence than the matching template rule or rules with the highest import precedence are eliminated from consideration.

2. 次に、合致したテンプレートルールのうち、優先度（ priority ）が最高でないものをすべて候補から外す。 テンプレートルールの優先度は、テンプレートルールの priority 属性で指定される。 優先度の値は実数であり（負も許容される）、オプションの先頭の負符号（ - ）に Number が後続する生成規則に合致しなければならない。 既定の優先度 は、次のように計算される。 Next, all matching template rules that have lower priority than the matching template rule or rules with the highest priority are eliminated from consideration. The priority of a template rule is specified by the priority attribute on the template rule. The value of this must be a real number (positive or negative), matching the production Number with an optional leading minus sign (-). The default priority is computed as follows:

   • パターンに | で区切られた複数の候補が含まれる場合、そのテンプレートは、候補それぞれに１個のテンプレートが存在するテンプレートの集合と同様に扱われる。 If the pattern contains multiple alternatives separated by |, then it is treated equivalently to a set of template rules, one for each alternative.

   • パターンが ChildOrAttributeAxisSpecifier から始まる QName 形式の場合, または ChildOrAttributeAxisSpecifier から始まる processing-instruction ( Literal ) 形式の場合、優先度は 0 。 If the pattern has the form of a QName preceded by a ChildOrAttributeAxisSpecifier or has the form processing-instruction(Literal) preceded by a ChildOrAttributeAxisSpecifier, then the priority is 0.

   • パターンが ChildOrAttributeAxisSpecifier から始まる NCName :* 形式の場合、優先度は -0.25 。 If the pattern has the form NCName:* preceded by a ChildOrAttributeAxisSpecifier, then the priority is -0.25.

   • 上記以外の, パターンが ChildOrAttributeAxisSpecifier から始まる NodeTest のみからなる場合、優先度は -0.5 。 Otherwise, if the pattern consists of just a NodeTest preceded by a ChildOrAttributeAxisSpecifier, then the priority is -0.5.

   • 他の場合、優先度は 0.5 。 Otherwise, the priority is 0.5.

   したがって、最もありふれたパターン（特定の型と特定の展開名を持つノードを選択するパターン）の優先度は 0 になる。 より条件が緩いパターン（特定の型と、特定の名前空間 URI を展開名に持つノードを選択するパターン）の優先度は -0.25 になる。 さらに条件が緩いパターン（単に特定の型を持つノードを選択するパターン）の優先度は -0.5 になる。 最もありふれたパターンより条件が厳しいパターンの優先度は 0.5 になる。 Thus, the most common kind of pattern (a pattern that tests for a node with a particular type and a particular expanded-name) has priority 0. The next less specific kind of pattern (a pattern that tests for a node with a particular type and an expanded-name with a particular namespace URI) has priority -0.25. Patterns less specific than this (patterns that just tests for nodes with particular types) have priority -0.5. Patterns more specific than the most common kind of pattern have priority 0.5.

この手続き後も, 合致するテンプレートルールが複数残る場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、残ったテンプレートルールからスタイルシートの最後方に現れるものを選択し、エラーから回復しなければならない。 It is an error if this leaves more than one matching template rule. An XSLT processor may signal the error; if it does not signal the error, it must recover by choosing, from amongst the matching template rules that are left, the one that occurs last in the stylesheet.

5.6 テンプレートルールの上書き

<!-- 分類：instruction -->
<xsl:apply-imports />

テンプレートルールが, インポートしたスタイルシートのテンプレートルールを上書き（ [5.5 テンプレートの競合解決] を見よ）していても、 xsl:apply-imports 要素を用いて上書きされたテンプレートルールを呼び出すことができる。 A template rule that is being used to override a template rule in an imported stylesheet (see [5.5 Conflict Resolution for Template Rules]) can use the xsl:apply-imports element to invoke the overridden template rule.

スタイルシート処理中は常に、 現在のテンプレートルール が存在する。 パターンの照合によりテンプレートルールが選択されると、ルール内のテンプレートをインスタンス化している間は, そのテンプレートルールが現在のテンプレートルールになる。 ただし, xsl:for-each 要素のインスタンス化においては、 xsl:for-each 要素の内容をインスタンス化している間は, 現在のテンプレートルールは null になる。 At any point in the processing of a stylesheet, there is a current template rule. Whenever a template rule is chosen by matching a pattern, the template rule becomes the current template rule for the instantiation of the rule's template. When an xsl:for-each element is instantiated, the current template rule becomes null for the instantiation of the content of the xsl:for-each element.

xsl:apply-imports は、現在のテンプレートルールが属するスタイルシート要素にインポートされたテンプレートルールのみを用いて, 現在のノードを処理する。 ノードは現在のテンプレートルールのモードで処理される。 現在のテンプレートルールが null のときに, xsl:apply-imports がインスタンス化された場合、エラーとする。 xsl:apply-imports processes the current node using only template rules that were imported into the stylesheet element containing the current template rule; the node is processed in the current template rule's mode. It is an error if xsl:apply-imports is instantiated when the current template rule is null.

例えば、スタイルシート doc.xsl に example 要素用のテンプレートルールが含まれていたとする： For example, suppose the stylesheet doc.xsl contains a template rule for example elements:

<xsl:template match="example">
  <pre><xsl:apply-templates/></pre>
</xsl:template>

doc.xsl をインポートする他のスタイルシートは、次のように example 要素の扱いを変更できる： Another stylesheet could import doc.xsl and modify the treatment of example elements as follows:

<xsl:import href="doc.xsl"/>

<xsl:template match="example">
  <div style="border: solid red">
     <xsl:apply-imports/>
  </div>
</xsl:template>

この組み合わせにより、 example 要素は次の形に変換される： The combined effect would be to transform an example into an element of the form:

<div style="border: solid red"><pre>...</pre></div>

5.7 モード

モードを利用すれば、要素を複数回処理させつつ, 毎回異なる結果が得られるようになる。 Modes allow an element to be processed multiple times, each time producing a different result.

xsl:template と xsl:apply-templates は、オプションで mode 属性を利用できる。 mode 属性の値は QName であり、 [2.4 修飾名] に則って展開される。 xsl:template が match 属性を持たない場合、 mode 属性も持ってはならない。 mode 属性が与えられている xsl:apply-templates 要素は、同じ mode 属性値を持つ xsl:template 要素のテンプレートルールのみを適用する。 mode 属性が与えられていない xsl:apply-templates 要素は、 mode 属性を持たない xsl:template 要素のテンプレートルールのみを適用する。 Both xsl:template and xsl:apply-templates have an optional mode attribute. The value of the mode attribute is a QName, which is expanded as described in [2.4 Qualified Names]. If xsl:template does not have a match attribute, it must not have a mode attribute. If an xsl:apply-templates element has a mode attribute, then it applies only to those template rules from xsl:template elements that have a mode attribute with the same value; if an xsl:apply-templates element does not have a mode attribute, then it applies only to those template rules from xsl:template elements that do not have a mode attribute.

5.8 組み込みテンプレートルール

合致するパターンを持つテンプレートルールがスタイルシートの中に明示的に与えられていなくても、再帰的な処理の継続を可能にする暗黙の組み込みテンプレートルールがある。 このテンプレートルールは、要素ノードとルートノードの両方に適用される。 組み込みテンプレートルールと等価の記述を次に示す： There is a built-in template rule to allow recursive processing to continue in the absence of a successful pattern match by an explicit template rule in the stylesheet. This template rule applies to both element nodes and the root node. The following shows the equivalent of the built-in template rule:

<xsl:template match="*|/">
  <xsl:apply-templates/>
</xsl:template>

それぞれのモードにも、スタイルシートの中に合致するパターンを持つテンプレートルールが明示的に与えられていなくても、同じモードによる再帰的な処理の継続を可能にする暗黙の組み込みテンプレートルールがある。 このテンプレートルールは、要素ノードとルートノードの両方に適用される。 モード m の組み込みテンプレートルールと等価の記述を次に示す： There is also a built-in template rule for each mode, which allows recursive processing to continue in the same mode in the absence of a successful pattern match by an explicit template rule in the stylesheet. This template rule applies to both element nodes and the root node. The following shows the equivalent of the built-in template rule for mode m.

<xsl:template match="*|/" mode="m">
  <xsl:apply-templates mode="m"/>
</xsl:template>

テキストノードと属性ノードについても、テキストを複製する暗黙の組み込みテンプレートルールが存在する： There is also a built-in template rule for text and attribute nodes that copies text through:

<xsl:template match="text()|@*">
  <xsl:value-of select="."/>
</xsl:template>

処理命令およびコメントに対する組み込みテンプレートルールは、何も実行しない。 The built-in template rule for processing instructions and comments is to do nothing.

<xsl:template match="processing-instruction()|comment()"/>

名前空間ノードに対する組み込みテンプレートルールも、何も実行しない。 名前空間ノードに合致し得るパターンは存在しないため、名前空間ノードに適用されるテンプレートルールは組み込みのものだけになる。 The built-in template rule for namespace nodes is also to do nothing. There is no pattern that can match a namespace node; so, the built-in template rule is the only template rule that is applied for namespace nodes.

組み込みテンプレートルールは、スタイルシートの前に暗黙的にインポートされたかのように扱われるため、 インポート優先順位 は他のすべてのテンプレートルールよりも低くなる。 従って, スタイルシート作成者は、テンプレートルールを明示的に与えることにより, 組み込みテンプレートルールを上書きできる。 The built-in template rules are treated as if they were imported implicitly before the stylesheet and so have lower import precedence than all other template rules. Thus, the author can override a built-in template rule by including an explicit template rule.

7.1 要素と属性の生成

<!-- 分類：top-level-element -->
<xsl:namespace-alias
  stylesheet-prefix = prefix | "#default"
  result-prefix = prefix | "#default" />

<xsl:stylesheet
  version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:fo="http://www.w3.org/1999/XSL/Format"
  xmlns:axsl="http://www.w3.org/1999/XSL/TransformAlias">

<xsl:namespace-alias stylesheet-prefix="axsl" result-prefix="xsl"/>

<xsl:template match="/">
  <axsl:stylesheet>
    <xsl:apply-templates/>
  </axsl:stylesheet>
</xsl:template>

<xsl:template match="block">
  <axsl:template match="{.}">
     <fo:block><axsl:apply-templates/></fo:block>
  </axsl:template>
</xsl:template>

</xsl:stylesheet>

<elements>
<block>p</block>
<block>h1</block>
<block>h2</block>
<block>h3</block>
<block>h4</block>
</elements>

<!-- 分類：instruction -->
<xsl:element
  name = { qname }
  namespace = { uri-reference }
  use-attribute-sets = qnames>
  <!-- 内容：template -->
</xsl:element>

<!-- 分類：instruction -->
<xsl:attribute
  name = { qname }
  namespace = { uri-reference }>
  <!-- 内容：template -->
</xsl:attribute>

<xsl:attribute name="xmlns:xsl" namespace="whatever">http://www.w3.org/1999/XSL/Transform</xsl:attribute>

<!-- 分類：top-level-element -->
<xsl:attribute-set
  name = qname 
  use-attribute-sets = qnames>
  <!-- 内容：xsl:attribute* -->
</xsl:attribute-set>

<xsl:template match="chapter/heading">
  <fo:block quadding="start" xsl:use-attribute-sets="title-style">
    <xsl:apply-templates/>
  </fo:block>
</xsl:template>

<xsl:attribute-set name="title-style">
  <xsl:attribute name="font-size">12pt</xsl:attribute>
  <xsl:attribute name="font-weight">bold</xsl:attribute>
</xsl:attribute-set>

7.2 テキストの生成

テンプレートは、テキストノードも含み得る。 [3.4 空白の削除] に則って空白の削除後にテンプレート内に残った各テキストノードは、結果ツリーの中で同一の文字列を持つテキストノードを生成する。 結果ツリーの中で隣接するテキストノードは自動的に連結されて一つに併合される。 A template can also contain text nodes. Each text node in a template remaining after whitespace has been stripped as specified in [3.4 Whitespace Stripping] will create a text node with the same string-value in the result tree. Adjacent text nodes in the result tree are automatically merged.

テキストはツリーレベルで処理されることに注意。 すなわち, テンプレート内のマークアップ < は、スタイルシートツリー内では, 文字 < を含むテキストノードで表現される。 この文字は、結果ツリー内で文字 < を含むテキストノードを生成する。 結果ツリーが XML 文書として外部に出力されると（ [16.4 出力エスケープの無効化] で述べるように出力エスケープが無効化されていない限り）、マークアップ < （または同等の文字参照）で表現される事になる。 Note that text is processed at the tree level. Thus, markup of &lt; in a template will be represented in the stylesheet tree by a text node that includes the character <. This will create a text node in the result tree that contains a < character, which will be represented by the markup &lt; (or an equivalent character reference) when the result tree is externalized as an XML document (unless output escaping is disabled as described in [16.4 Disabling Output Escaping]).

<!-- 分類：instruction -->
<xsl:text
  disable-output-escaping = "yes" | "no">
  <!-- 内容：#PCDATA -->
</xsl:text>

リテラル文字データは xsl:text 要素にくるむこともできる。 このラッピングは、どの空白文字が削除されるかを変更し得るが（ [3.4 空白の削除] を見よ）, その後の XSLT プロセッサによる文字の扱い方には影響しない。 Literal data characters may also be wrapped in an xsl:text element. This wrapping may change what whitespace characters are stripped (see [3.4 Whitespace Stripping]) but does not affect how the characters are handled by the XSLT processor thereafter.

注記： xml:lang 属性と xml:space 属性は XSLT プロセッサからは特別に扱われない。 特に： NOTE:The xml:lang and xml:space attributes are not treated specially by XSLT. In particular,

• 結果ツリーに必要になるすべての xml:lang 属性と xml:space 属性に関し、それらの明示的な生成はスタイルシート作成者が責を負う。 it is the responsibility of the stylesheet author explicitly to generate any xml:lang or xml:space attributes that are needed in the result;

• XSLT 名前空間の要素に xml:lang 属性や xml:space 属性を指定しても、結果に xml:lang属性や xml:space 属性を生じさせることはない。 specifying an xml:lang or xml:space attribute on an element in the XSLT namespace will not cause any xml:lang or xml:space attributes to appear in the result.

7.3 処理命令の生成

<!-- 分類：instruction -->
<xsl:processing-instruction
  name = { ncname }>
  <!-- 内容：template -->
</xsl:processing-instruction>

xsl:processing-instruction 要素のインスタンス化により、処理命令ノードが生成される。 xsl:processing-instruction 要素の内容は、処理命令ノードの文字列値のテンプレートである。 xsl:processing-instruction 要素は、処理命令ノードの名前を指定する必須の name 属性を持つ。 name 属性の値は 属性値テンプレートとして処理される。 The xsl:processing-instruction element is instantiated to create a processing instruction node. The content of the xsl:processing-instruction element is a template for the string-value of the processing instruction node. The xsl:processing-instruction element has a required name attribute that specifies the name of the processing instruction node. The value of the name attribute is interpreted as an attribute value template.

例えば, For example, this

<xsl:processing-instruction name="xml-stylesheet">href="book.css" type="text/css"</xsl:processing-instruction>

は、次の処理命令を生成する。 would create the processing instruction

<?xml-stylesheet href="book.css" type="text/css"?>

name 属性をインスタンス化した結果の文字列が, NCName かつ PITarget にならない場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、結果ツリーに処理命令を追加しないことにより, エラーから回復しなければならない。 It is an error if the string that results from instantiating the name attribute is not both an NCName and a PITarget. An XSLT processor may signal the error; if it does not signal the error, it must recover by not adding the processing instruction to the result tree.

注記： これは xsl:processing-instruction を XML 宣言の出力に利用できないことを意味する。 この目的には、代わりに xsl:output 要素（ [16 出力] を見よ）を利用すべきである。 NOTE:This means that xsl:processing-instruction cannot be used to output an XML declaration. The xsl:output element should be used instead (see [16 Output]).

xsl:processing-instruction の内容がインスタンス化される際に, テキストノード以外のノードが生成された場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、問題が生じたノードとその内容を無視して, エラーから回復しなければならない。 It is an error if instantiating the content of xsl:processing-instruction creates nodes other than text nodes. An XSLT processor may signal the error; if it does not signal the error, it must recover by ignoring the offending nodes together with their content.

xsl:processing-instruction の内容がインスタンス化された結果に文字列 ?> が含まれる場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、 > が直後に続く ? すべてに後ろに１個のスペースを挿入して, エラーから回復しなければならない。 It is an error if the result of instantiating the content of the xsl:processing-instruction contains the string ?>. An XSLT processor may signal the error; if it does not signal the error, it must recover by inserting a space after any occurrence of ? that is followed by a >.

7.4 コメントの生成

<!-- 分類：instruction -->
<xsl:comment>
  <!-- 内容：template -->
</xsl:comment>

xsl:comment 要素がインスタンス化されると、結果ツリー内にコメントノードが生成される。 xsl:comment 要素の内容は、コメントノードの文字列値のテンプレートである。 The xsl:comment element is instantiated to create a comment node in the result tree. The content of the xsl:comment element is a template for the string-value of the comment node.

例えば For example, this

<xsl:comment>This file is automatically generated.
Do not edit!</xsl:comment>

は、次のコメントを生成する。 would create the comment

<!--This file is automatically generated.
Do not edit!-->

xsl:comment の内容がインスタンス化される際に, テキストノード以外のノードが生成された場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、問題の生じたノードとその内容を無視して, エラーから回復しなければならない。 It is an error if instantiating the content of xsl:comment creates nodes other than text nodes. An XSLT processor may signal the error; if it does not signal the error, it must recover by ignoring the offending nodes together with their content.

xsl:comment の内容がインスタンス化された結果に 文字列 -- が含まれていたり, 末尾に - がある場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、連続する - の間すべて, およびコメントの末尾の - の直後にスペースを１個挿入して, エラーから回復しなければならない。 It is an error if the result of instantiating the content of the xsl:comment contains the string -- or ends with -. An XSLT processor may signal the error; if it does not signal the error, it must recover by inserting a space after any occurrence of - that is followed by another - or that ends the comment.

7.5 複製

<!-- 分類：instruction -->
<xsl:copy
  use-attribute-sets = qnames>
  <!-- 内容：template -->
</xsl:copy>

xsl:copy 要素を利用すると、現在のノードを容易に複製できる。 xsl:copy 要素がインスタンス化されると、現在のノードの複製が生成される。 現在のノードの名前空間ノードも自動的に複製されるが, ノードの属性と子は自動的に複製されない。 xsl:copy 要素の内容は、生成されるノードの属性と子を生成するテンプレートである。 この内容は、属性や子を持てるノード型（すなわち、ルートノードと要素ノード）に限ってインスタンス化される。 The xsl:copy element provides an easy way of copying the current node. Instantiating the xsl:copy element creates a copy of the current node. The namespace nodes of the current node are automatically copied as well, but the attributes and children of the node are not automatically copied. The content of the xsl:copy element is a template for the attributes and children of the created node; the content is instantiated only for nodes of types that can have attributes or children (i.e. root nodes and element nodes).

xsl:copy 要素は use-attribute-sets 属性 （ [7.1.4 名前付き属性の集合] を見よ） を持てる。 この属性は、要素ノードを複製するときにのみ利用される。 The xsl:copy element may have a use-attribute-sets attribute (see [7.1.4 Named Attribute Sets]). This is used only when copying element nodes.

結果ツリーのルートノードは暗黙的に生成されるため、ルートノードだけは特別に扱われる。 現在のノードがルートノードだった場合、 xsl:copy はルートノードを生成せず, 単にその内容のテンプレートを利用する。 The root node is treated specially because the root node of the result tree is created implicitly. When the current node is the root node, xsl:copy will not create a root node, but will just use the content template.

例えば、恒等変換は xsl:copy を用いて次のように記述できる： For example, the identity transformation can be written using xsl:copy as follows:

<xsl:template match="@*|node()">
  <xsl:copy>
    <xsl:apply-templates select="@*|node()"/>
  </xsl:copy>
</xsl:template>

現在のノードが属性ノードの場合、現在のノードと同名の属性を生成するために xsl:attribute を利用するとエラーになるような状況においては, xsl:copy の利用もエラーとする（ [7.1.3 xsl:attribute による属性の生成] を見よ）。 When the current node is an attribute, then if it would be an error to use xsl:attribute to create an attribute with the same name as the current node, then it is also an error to use xsl:copy (see [7.1.3 Creating Attributes with xsl:attribute]).

現在のノードが名前空間ノードの場合、複製により, 結果ツリーにおいてその親ノードに名前空間ノードが追加される。 その親ノードが要素でなかった場合、エラーとする。 実装は、エラーを通知してもよいし, その名前空間ノードを無視してもよい。 要素に子ノードや属性ノードを追加した後に, 名前空間ノードを追加するのは、エラーとする。 実装は、エラーを通知してもよいし, その名前空間ノードを無視してもよい。 既に同じ名前の名前空間を持っている要素に名前空間ノードを追加した場合、２つの名前空間ノードが同じ 文字列値 でない限り（この場合の重複は無視される）, エラーとする。 null 名前空間 URI を持つ要素に null 名の名前空間ノードを追加するのは、エラーとする。 When the current node is a namespace node, then copying it adds a namespace node to the containing node in the result tree. It is an error if this containing node is not an element; implementations may either signal the error or ignore the namespace node. It is an error to add a namespace node to an element after children have been added to it or after attributes have been added to it; implementations may either signal an error or ignore the namespace node. It is an error to add a namespace node to an element if the element already has a namespace node with the same name, unless both namespace nodes have the same string-value, in which case the duplicate is ignored. It is an error to add a namespace node to an element if the namespace node has a null name and the element has a null namespace URI.

次の例に、ソースツリーから結果ツリーへの xml:lang 属性の複製がいかに容易かを示す。 スタイルシートに、次の名前付きテンプレートが定義されているとする： The following example shows how xml:lang attributes can be easily copied through from source to result. If a stylesheet defines the following named template:

<xsl:template name="apply-templates-copy-lang">
 <xsl:for-each select="@xml:lang">
   <xsl:copy/>
 </xsl:for-each>
 <xsl:apply-templates/>
</xsl:template>

このとき, xml:lang 属性の複製は、単に then it can simply do

<xsl:call-template name="apply-templates-copy-lang"/>

と記述すればよく, instead of

<xsl:apply-templates/>

を用いる必要はない。 when it wants to copy the xml:lang attribute.

7.6 テキストの動的生成

テンプレート内では, xsl:value-of 要素を、ソースツリーからのテキストの取得や変数の値の挿入など, 演算によるテキスト生成に利用できる。 この処理は xsl:value-of 要素の select 属性の値に指定された 式 を用いて行われる。 式は、リテラル結果要素の属性値においても波括弧（ {} ）に括って利用できる。 Within a template, the xsl:value-of element can be used to compute generated text, for example by extracting text from the source tree or by inserting the value of a variable. The xsl:value-of element does this with an expression that is specified as the value of the select attribute. Expressions can also be used inside attribute values of literal result elements by enclosing the expression in curly braces ({}).

<!-- 分類：instruction -->
<xsl:value-of
  select = string-expression 
  disable-output-escaping = "yes" | "no" />

<xsl:template match="person">
  <p>
   <xsl:value-of select="@given-name"/>
   <xsl:text> </xsl:text>
   <xsl:value-of select="@family-name"/>
  </p>
</xsl:template>

<xsl:template match="person">
  <p>
   <xsl:value-of select="given-name"/>
   <xsl:text> </xsl:text>
   <xsl:value-of select="family-name"/>
  </p>
</xsl:template>

<xsl:template match="procedure">
  <fo:block>
    <xsl:value-of select="ancestor-or-self::*[@security][1]/@security"/>
  </fo:block>
  <xsl:apply-templates/>
</xsl:template>

<xsl:variable name="image-dir">/images</xsl:variable>

<xsl:template match="photograph">
<img src="{$image-dir}/{href}" width="{size/@width}"/>
</xsl:template>

<photograph>
  <href>headquarters.jpg</href>
  <size width="300"/>
</photograph>

<img src="/images/headquarters.jpg" width="300"/>

<a href="#{id({@ref})/title}">

<a href="#{id(@ref)/title}">

7.7 番号付け

<!-- 分類：instruction -->
<xsl:number
  level = "single" | "multiple" | "any"
  count = pattern 
  from = pattern 
  value = number-expression 
  format = { string }
  lang = { nmtoken }
  letter-value = { "alphabetic" | "traditional" }
  grouping-separator = { char }
  grouping-size = { number } />

xsl:number 要素は、結果ツリーにフォーマット化した数値を挿入するために利用される。 挿入する数値は、式で指定してもよい。 value 属性の値は 式 を含む。 この式が評価されると、結果のオブジェクトは number 関数を呼び出したかのように数値に変換される。 数値が NaN, infinite になった場合, または 0.5 より小さくなった場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、数値を string 関数を呼び出したかのように文字列に変換して, エラーから回復しなければならない。 他の場合、 この数値は整数に丸められ, [7.7.1 数値から文字列への変換属性] で述べる属性により文字列に変換される。 この処理において、これらの属性値はそれぞれ 属性値テンプレート として処理される。 変換後の結果の文字列が結果ツリーに挿入される。 次の例は、ソートされたリストに番号付けを行う。 The xsl:number element is used to insert a formatted number into the result tree. The number to be inserted may be specified by an expression. The value attribute contains an expression. The expression is evaluated and the resulting object is converted to a number as if by a call to the number function. It is an error if the number is NaN, infinite or less than 0.5; an XSLT processor may signal the error; if it does not signal the error, it must recover by converting the number to a string as if by a call to the string function and inserting the resulting string into the result tree. Otherwise, The number is rounded to an integer and then converted to a string using the attributes specified in [7.7.1 Number to String Conversion Attributes]; in this context, the value of each of these attributes is interpreted as an attribute value template. After conversion, the resulting string is inserted in the result tree. For example, the following example numbers a sorted list:

<xsl:template match="items">
  <xsl:for-each select="item">
    <xsl:sort select="."/>
    <p>
      <xsl:number value="position()" format="1. "/>
      <xsl:value-of select="."/>
    </p>
  </xsl:for-each>
</xsl:template>

value 属性が指定されていない場合、 xsl:number 要素はソースツリー内の現在のノード位置に基づいて数値を挿入する。 次に挙げる属性は、現在のノードに対する番号付けの方法を制御する。 If no value attribute is specified, then the xsl:number element inserts a number based on the position of the current node in the source tree. The following attributes control how the current node is to be numbered:

• level 属性は、対象とすべきソースツリーのレベルを指定する。 この属性の値は、 single, multiple, any のいずれかになる。 既定値は single 。 The level attribute specifies what levels of the source tree should be considered; it has the values single, multiple or any. The default is single.

• count 属性は、上で指定したレベルにおいて, カウント対象にすべきノードを指定するパターンを与える。 count 属性が指定されていない場合、現在のノードと同じノード型を持つすべてのノードに合致するパターンが既定の値として用いられ, 現在のノードが展開名を持っている場合は、同じ展開名を持つすべてのノードに合致するパターンが既定の値として用いられる。 The count attribute is a pattern that specifies what nodes should be counted at those levels. If count attribute is not specified, then it defaults to the pattern that matches any node with the same node type as the current node and, if the current node has an expanded-name, with the same expanded-name as the current node.

• from 属性は、カウントの開始位置を指定するパターンを与える。 The from attribute is a pattern that specifies where counting starts.

加えて, 数値から文字列への変換には、 value 属性が指定された場合と同様に [7.7.1 数値から文字列への変換属性] で述べる属性が利用される。 In addition, the attributes specified in [7.7.1 Number to String Conversion Attributes] are used for number to string conversion, as in the case when the value attribute is specified.

xsl:number 要素は、まず, level 属性, count 属性, from 属性から正の整数のリストを構築する。 The xsl:number element first constructs a list of positive integers using the level, count and from attributes:

• level="single" の場合、 ancestor-or-self 軸の中で count パターンに合致する最初のノードまで遡り, その先祖の前にある同胞ノードのうち count パターンに合致する同胞ノードの総数に１を加えた値１個からなるリストを構築する。 そのような先祖が存在しない場合、リストは空とする。 from 属性が指定されている場合、検索される先祖の範囲は from パターンに合致する最も近い先祖の子孫に限られる。 （ここで, 前にある同胞とは、 preceding-sibling 軸に入るノードを意味する。） When level="single", it goes up to the first node in the ancestor-or-self axis that matches the count pattern, and constructs a list of length one containing one plus the number of preceding siblings of that ancestor that match the count pattern. If there is no such ancestor, it constructs an empty list. If the from attribute is specified, then the only ancestors that are searched are those that are descendants of the nearest ancestor that matches the from pattern. Preceding siblings has the same meaning here as with the preceding-sibling axis.

• level="multiple" の場合、現在のノードのすべての先祖を文書順に並べ, この要素自身を最後に加えたリストを構築する。 次に, このリストから count パターンに合致するノードのみを残し, 他を取り除く。 最後に, リストに含まれる各ノードを、そのノードの前にある同胞ノードのうち, count パターンに合致する同胞ノードの総数に１を加えた数に置き換える。 from 属性が指定されている場合、検索される先祖の範囲は from パターンに合致する最も近い先祖の子孫に限られる。 （ここで, 前にある同胞とは、 preceding-sibling 軸に入るノードを意味する。） When level="multiple", it constructs a list of all ancestors of the current node in document order followed by the element itself; it then selects from the list those nodes that match the count pattern; it then maps each node in the list to one plus the number of preceding siblings of that node that match the count pattern. If the from attribute is specified, then the only ancestors that are searched are those that are descendants of the nearest ancestor that matches the from pattern. Preceding siblings has the same meaning here as with the preceding-sibling axis.

• level="any" の場合、現在のノードと（文書内のレベルを問わず）文書順で現在のノードの前にあるノードのうち, 名前空間ノードと属性ノードを除くすべてのノードの集合（すなわち preceding 軸と ancestor-or-self 軸に入るノードの和集合）の中で, count パターンに合致するものの総数１個からなるリストを構築する。 合致するものが存在しない場合、リストは空とする。 from 属性が指定されている場合、検索されるノードの範囲は from パターンに最初に合致するノードより後のノードに限られる。 When level="any", it constructs a list of length one containing the number of nodes that match the count pattern and belong to the set containing the current node and all nodes at any level of the document that are before the current node in document order, excluding any namespace and attribute nodes (in other words the union of the members of the preceding and ancestor-or-self axes). If there are no matching nodes, it constructs an empty list. If the from attribute is specified, then only nodes after the first node before the current node that match the from pattern are considered.

次に、上で構築した数のリストを [7.7.1 数値から文字列への変換属性] で述べる属性を用いて文字列に変換する。 この処理においては, これらの属性値は、それぞれ 属性値テンプレート として処理される。 変換後の結果の文字列が結果ツリーに挿入される。 The list of numbers is then converted into a string using the attributes specified in [7.7.1 Number to String Conversion Attributes]; in this context, the value of each of these attributes is interpreted as an attribute value template. After conversion, the resulting string is inserted in the result tree.

次の例は、順序付きリスト（ ol ）の項目（ item ）に対する番号付けを行なう。 The following would number the items in an ordered list:

<xsl:template match="ol/item">
  <fo:block>
    <xsl:number/><xsl:text>. </xsl:text><xsl:apply-templates/>
  </fo:block>
<xsl:template>

次の２つのルールは、 title 要素に番号付けを行う。 この例では、一連の chapter と後続の appendix を含む文書が意図されている。 これらの chapter と appendix のいずれも section を含み, section は subsection を含んでいるとする。 chapter は 1, 2, 3, ... , appendix は A, B, C, ... , chapter の中の section は 1.1, 1.2, 1.3, ..., appendix の中の section は A.1, A.2, A.3, ... のような形に番号が振られる。 The following two rules would number title elements. This is intended for a document that contains a sequence of chapters followed by a sequence of appendices, where both chapters and appendices contain sections, which in turn contain subsections. Chapters are numbered 1, 2, 3; appendices are numbered A, B, C; sections in chapters are numbered 1.1, 1.2, 1.3; sections in appendices are numbered A.1, A.2, A.3.

<xsl:template match="title">
  <fo:block>
     <xsl:number level="multiple"
                 count="chapter|section|subsection"
                 format="1.1 "/>
     <xsl:apply-templates/>
  </fo:block>
</xsl:template>

<xsl:template match="appendix//title" priority="1">
  <fo:block>
     <xsl:number level="multiple"
                 count="appendix|section|subsection"
                 format="A.1 "/>
     <xsl:apply-templates/>
  </fo:block>
</xsl:template>

次の例は、 chapter の中の note に番号付けを行う： The following example numbers notes sequentially within a chapter:

<xsl:template match="note">
  <fo:block>
     <xsl:number level="any" from="chapter" format="(1) "/>
     <xsl:apply-templates/>
  </fo:block>
</xsl:template>

次の例では、 HTML の H4 要素に対し、３部分からなるラベルで番号付けを行う： The following example would number H4 elements in HTML with a three-part label:

<xsl:template match="H4">
 <fo:block>
   <xsl:number level="any" from="H1" count="H2"/>
   <xsl:text>.</xsl:text>
   <xsl:number level="any" from="H2" count="H3"/>
   <xsl:text>.</xsl:text>
   <xsl:number level="any" from="H3" count="H4"/>
   <xsl:text> </xsl:text>
   <xsl:apply-templates/>
 </fo:block>
</xsl:template>

9.1 xsl:if による条件処理

<!-- 分類：instruction -->
<xsl:if
  test = boolean-expression>
  <!-- 内容：template -->
</xsl:if>

xsl:if 要素は 式 を指定する test 属性を持つ。 要素の内容はテンプレートである。 式が評価されると、結果のオブジェクトは boolean 関数を呼び出したかのようにブール型に変換され, 結果が真の場合、内容のテンプレートがインスタンス化され, そうでなければ何も生成されない。 次の例は namelist に含まれる name をコンマ区切りのリストにフォーマットする： The xsl:if element has a test attribute, which specifies an expression. The content is a template. The expression is evaluated and the resulting object is converted to a boolean as if by a call to the boolean function. If the result is true, then the content template is instantiated; otherwise, nothing is created. In the following example, the names in a group of names are formatted as a comma separated list:

<xsl:template match="namelist/name">
  <xsl:apply-templates/>
  <xsl:if test="not(position()=last())">, </xsl:if>
</xsl:template>

次の例は、表の行を１行おきに yellow にする： The following colors every other table row yellow:

<xsl:template match="item">
  <tr>
    <xsl:if test="position() mod 2 = 0">
       <xsl:attribute name="bgcolor">yellow</xsl:attribute>
    </xsl:if>
    <xsl:apply-templates/>
  </tr>
</xsl:template>

9.2 xsl:choose による条件処理

<!-- 分類：instruction -->
<xsl:choose>
  <!-- 内容：(xsl:when+, xsl:otherwise?) -->
</xsl:choose>

<xsl:when
  test = boolean-expression>
  <!-- 内容：template -->
</xsl:when>

<xsl:otherwise>
  <!-- 内容：template -->
</xsl:otherwise>

xsl:choose 要素は、いくつかの選択肢の中から一つを選択する。 この要素の内容は、一連の xsl:when 要素と, 後続するオプションの xsl:otherwise 要素からなる。 各 xsl:when 要素は 式 を指定する１個の属性 test を持つ。 xsl:when 要素と xsl:otherwise 要素の内容は、テンプレートである。 xsl:choose 要素の処理においては、各 xsl:when 要素が順番にテストされる。 各テストでは、 test に与えた式が評価され, その結果のオブジェクトが boolean 関数を呼び出しかのようにブール型に変換される。 テスト結果が真になる xsl:when 要素のうち、最初の要素の内容のみがインスタンス化される。 テスト結果が真になる xsl:when が存在しない場合、 xsl:otherwise 要素の内容がインスタンス化される。 テスト結果が真の xsl:when 要素が存在せず, xsl:otherwise 要素も存在しない場合、何も生成されない。 The xsl:choose element selects one among a number of possible alternatives. It consists of a sequence of xsl:when elements followed by an optional xsl:otherwise element. Each xsl:when element has a single attribute, test, which specifies an expression. The content of the xsl:when and xsl:otherwise elements is a template. When an xsl:choose element is processed, each of the xsl:when elements is tested in turn, by evaluating the expression and converting the resulting object to a boolean as if by a call to the boolean function. The content of the first, and only the first, xsl:when element whose test is true is instantiated. If no xsl:when is true, the content of the xsl:otherwise element is instantiated. If no xsl:when element is true, and no xsl:otherwise element is present, nothing is created.

次の例は、順序付きリスト（ orderedlist ）の各項目（ item ）に対し、リストの入れ子の深さに応じて, アラビア数字, アルファベット, ローマ数字による番号を振る。 The following example enumerates items in an ordered list using arabic numerals, letters, or roman numerals depending on the depth to which the ordered lists are nested.

<xsl:template match="orderedlist/listitem">
  <fo:list-item indent-start='2pi'>
    <fo:list-item-label>
      <xsl:variable name="level"
                    select="count(ancestor::orderedlist) mod 3"/>
      <xsl:choose>
        <xsl:when test='$level=1'>
          <xsl:number format="i"/>
        </xsl:when>
        <xsl:when test='$level=2'>
          <xsl:number format="a"/>
        </xsl:when>
        <xsl:otherwise>
          <xsl:number format="1"/>
        </xsl:otherwise>
      </xsl:choose>
      <xsl:text>. </xsl:text>
    </fo:list-item-label>
    <fo:list-item-body>
      <xsl:apply-templates/>
    </fo:list-item-body>
  </fo:list-item>
</xsl:template>

11.1 結果ツリー素片

変数は式言語に新しいデータ型を導入する。 この追加のデータ型を、 結果ツリー素片 と呼ぶ。 変数を XPath の４種の基本データ型（ string, number, boolean, node-set ）のいずれかではなく、結果ツリー素片に束縛してもよい。 結果ツリー素片は、結果ツリーの素片を表現する。 結果ツリー素片は、ルートノード１個のみからなるノード集合と等価に扱われる。 ただし、結果ツリー素片に許容される演算は、ノード集合に許容される演算のサブセットになる。 文字列に許容される演算のみが、結果ツリー素片に許容される（文字列に対する演算には、最初に数値やブール型に変換する処理も含まれ得る）。 特に, 結果ツリー素片に対しては演算子 /, //, [] は許容されない。 結果ツリー素片に許容される演算は、等価なノード集合に対する演算と全く同じに実行される。 Variables introduce an additional data-type into the expression language. This additional data type is called result tree fragment. A variable may be bound to a result tree fragment instead of one of the four basic XPath data-types (string, number, boolean, node-set). A result tree fragment represents a fragment of the result tree. A result tree fragment is treated equivalently to a node-set that contains just a single root node. However, the operations permitted on a result tree fragment are a subset of those permitted on a node-set. An operation is permitted on a result tree fragment only if that operation would be permitted on a string (the operation on the string may involve first converting the string to a number or boolean). In particular, it is not permitted to use the /, //, and [] operators on result tree fragments. When a permitted operation is performed on a result tree fragment, it is performed exactly as it would be on the equivalent node-set.

結果ツリー素片が結果ツリーに複製される際は（ [11.3 xsl:copy-of における変数とパラメタの値の利用] を見よ）、その結果ツリー素片と等価なノード集合におけるルートノードのすべての子ノードが、連続する形で結果ツリーに追加される。 When a result tree fragment is copied into the result tree (see [11.3 Using Values of Variables and Parameters with xsl:copy-of]), then all the nodes that are children of the root node in the equivalent node-set are added in sequence to the result tree.

式の評価結果が結果ツリー素片の型になるのは、結果ツリー素片型の変数を参照したときか, 結果ツリー素片を返す拡張関数を呼び出したときか, 値が結果ツリー素片のシステムプロパティを取得したときか、のいずれかのみである。 Expressions can only return values of type result tree fragment by referencing variables of type result tree fragment or calling extension functions that return a result tree fragment or getting a system property whose value is a result tree fragment.

11.2 変数とパラメタの値

変数束縛要素には、次の３方法いずれかにより変数の値を指定できる。 A variable-binding element can specify the value of the variable in three alternative ways.

• 変数束縛要素が select 属性を持つ場合、属性値は 式 でなければならない。 この変数の値は、式の評価結果のオブジェクトになる。 この場合、要素の内容は空でなければならない。 If the variable-binding element has a select attribute, then the value of the attribute must be an expression and the value of the variable is the object that results from evaluating the expression. In this case, the content must be empty.

• 変数束縛要素が select 属性を持たず, 空でない内容を持つ場合（すなわち、変数束縛要素が１個以上の子ノードを持つ場合）、その内容が変数の値になる。 変数束縛要素の内容はテンプレートであり, 変数の値はこのテンプレートのインスタンス化により得られる。 この値は、テンプレートのインスタンス化で生成される一連のノードを子として持つルートノード１個からなるノード集合と等価な, 結果ツリー素片である。 結果ツリー素片のノードの基底 URI は、変数束縛要素の基底 URI になる。 If the variable-binding element does not have a select attribute and has non-empty content (i.e. the variable-binding element has one or more child nodes), then the content of the variable-binding element specifies the value. The content of the variable-binding element is a template, which is instantiated to give the value of the variable. The value is a result tree fragment equivalent to a node-set containing just a single root node having as children the sequence of nodes produced by instantiating the template. The base URI of the nodes in the result tree fragment is the base URI of the variable-binding element.

  ルートノードは属性ノードや名前空間ノードを子に持てないので、テンプレートのインスタンス化により生成される一連のノードに 属性ノードや名前空間ノードがあった場合、エラーとする。 XSLT プロセッサは、エラーを通知してもよい。 エラーを通知しない場合、属性ノードまたは名前空間ノードを追加しないことにより, エラーから回復しなければならない。 It is an error if a member of the sequence of nodes created by instantiating the template is an attribute node or a namespace node, since a root node cannot have an attribute node or a namespace node as a child. An XSLT processor may signal the error; if it does not signal the error, it must recover by not adding the attribute node or namespace node.

• 変数束縛要素の内容が空, かつ select 属性もない場合、変数の値は空文字列になる。従って 従って, If the variable-binding element has empty content and does not have a select attribute, then the value of the variable is an empty string. Thus

  <xsl:variable name="x"/>

  は、次と等価になる。 is equivalent to

  <xsl:variable name="x" select="''"/>

注記： 位置によってノードを選択する目的で変数を利用する場合、次のように記述しないように注意する。 NOTE:When a variable is used to select nodes by position, be careful not to do:

<xsl:variable name="n">2</xsl:variable>
...
<xsl:value-of select="item[$n]"/>

この記述では、最初の item 要素の値を出力することになる。 これは、変数 n が数値ではなく, 結果ツリー素片に束縛されるためである。 This will output the value of the first item element, because the variable n will be bound to a result tree fragment, not a number.

代わりに、次のいずれかにする： Instead, do either

<xsl:variable name="n" select="2"/>
...
<xsl:value-of select="item[$n]"/>

or

<xsl:variable name="n">2</xsl:variable>
...
<xsl:value-of select="item[position()=$n]"/>

注記： 空のノード集合をパラメタの既定値として指定する場合、次のようにするのが便利である。 NOTE:One convenient way to specify the empty node-set as the default value of a parameter is:

<xsl:param name="x" select="/.."/>

11.3 xsl:copy-of における変数とパラメタの値の利用

<!-- 分類：instruction -->
<xsl:copy-of
  select = expression />

xsl:copy-of 要素の利用により、 xsl:value-of のときのような文字列への変換を行わずに（ [7.6.1 xsl:value-of によるテキストの生成] を見よ）、結果ツリー素片を結果ツリーに挿入できる。 必須の select 属性には、 式 が含まれる。 式の評価結果が結果ツリー素片であれば、その完全な素片が結果ツリーの中に複製される。 評価結果がノード集合の場合は、その全ノードが文書順に結果ツリーの中に複製され, 要素ノードの複製に伴なって属性ノード, 名前空間ノード, 要素ノードの子も複製される。 ルートノード１個はその子の複製により複製される。 属性ノードと名前空間ノードの複製については xsl:copy と同じ規則が適用される（ [7.5 複製] を見よ）。 評価結果がノード集合でも結果ツリー素片でもない場合、 xsl:value-of の場合と同様に文字列に変換されてから結果ツリーに挿入される。 The xsl:copy-of element can be used to insert a result tree fragment into the result tree, without first converting it to a string as xsl:value-of does (see [7.6.1 Generating Text with xsl:value-of]). The required select attribute contains an expression. When the result of evaluating the expression is a result tree fragment, the complete fragment is copied into the result tree. When the result is a node-set, all the nodes in the set are copied in document order into the result tree; copying an element node copies the attribute nodes, namespace nodes and children of the element node as well as the element node itself; a root node is copied by copying its children. For copying an attribute or namespace node, the same rules apply as with xsl:copy (see [7.5 Copying]). When the result is neither a node-set nor a result tree fragment, the result is converted to a string and then inserted into the result tree, as with xsl:value-of.

11.4 トップレベルの変数とパラメタ

xsl:variable と xsl:param は トップレベル 要素として利用できる。 トップレベルに置く変数束縛要素は、どこからでも見える大域変数を宣言する （他の束縛により 隠蔽 されない限り） 。 トップレベルの xsl:param 要素はスタイルシートに渡すパラメタを宣言する。 XSLT においては、どのパラメタをスタイルシートに渡すかの仕組みは定義しない。 一つのスタイルシートに, 同じ名前の束縛が複数ある場合、最も インポート優先順位 が高いものが利用される。 一つのスタイルシートに, 名前も インポート優先順位 も同じトップレベルの変数束縛が複数含まれる場合、エラーとする。 トップレベルにおいて, 変数の値を指定する式またはテンプレートは、ソース文書のルートノードを処理する際に利用される文脈と同じ文脈で評価される：すなわち, 現在のノードはソース文書のルートノード, 現在のノードリストはソース文書のルートノード１個からなる。 それらのテンプレートや式が大域変数 x の値を指定していて、大域変数 y を参照している場合、y の値は x の値より先に算出されなければならない。 いずれかの大域変数定義でこの順序の処理ができなくなる場合, すなわち定義が循環している場合、エラーとする。 Both xsl:variable and xsl:param are allowed as top-level elements. A top-level variable-binding element declares a global variable that is visible everywhere (except where it is shadowed by another binding). A top-level xsl:param element declares a parameter to the stylesheet; XSLT does not define the mechanism by which parameters are passed to the stylesheet. If a stylesheet contains more than one binding for a variable of a particular name, then the binding with the highest import precedence is used. It is an error if a stylesheet contains more than one binding of a top-level variable with the same name and same import precedence. At the top-level, the expression or template specifying the variable value is evaluated with the same context as that used to process the root node of the source document: the current node is the root node of the source document and the current node list is a list containing just the root node of the source document. If the template or expression specifying the value of a global variable x references a global variable y, then the value for y must be computed before the value of x. It is an error if it is impossible to do this for all global variable definitions; in other words, it is an error if the definitions are circular.

次の例は、大域変数 para-font-size を宣言し, 属性値テンプレートから参照させる。 This example declares a global variable para-font-size, which it references in an attribute value template.

<xsl:variable name="para-font-size">12pt</xsl:variable>

<xsl:template match="para">
 <fo:block font-size="{$para-font-size}">
   <xsl:apply-templates/>
 </fo:block>
</xsl:template>

11.5 テンプレート内の変数とパラメタ

xsl:variable と xsl:param のいずれも、トップレベルに限らず, テンプレート内でも利用できる。 xsl:variable は、テンプレート内で命令が利用できる場所なら, どこでも利用できる。 この場合、束縛は xsl:fallback 命令を除く後続のすべての同胞の子孫 から参照できる。 この束縛は xsl:variable 要素自身からは見えないことに注意。 xsl:param は、xsl:template 要素の先頭の子として記述できる。 この場合、束縛は xsl:fallback 命令を除く後続のすべての同胞の子孫 から参照できる。 この束縛は xsl:param 要素自身からは見えないことに注意。 As well as being allowed at the top-level, both xsl:variable and xsl:param are also allowed in templates. xsl:variable is allowed anywhere within a template that an instruction is allowed. In this case, the binding is visible for all following siblings and their descendants the descendants of all following siblings that are not xsl:fallback instructions. Note that the binding is not visible for the xsl:variable element itself. xsl:param is allowed as a child at the beginning of an xsl:template element. In this context, the binding is visible for all following siblings and their descendants the descendants of all following siblings that are not xsl:fallback instructions. Note that the binding is not visible for the xsl:param element itself.

同じ名前の他の束縛が見える位置に新たに現れた束縛は、その束縛を 隠蔽する 。 テンプレート内の xsl:variable 要素や xsl:param 要素が確立する束縛が, 同じテンプレート内の xsl:variable 要素や xsl:param 要素が確立した束縛を 隠蔽 する場合、エラーとする。 テンプレート内の xsl:variable 要素や xsl:param 要素が確立した束縛が、 トップレベル の xsl:variable 要素や xsl:param 要素が確立した束縛を 隠蔽 するのはエラーではない。 この場合、トップレベルの束縛はスタイルシート内で他の束縛により隠蔽される場所からは見えなくなる。 従って, 次はエラーになるが： A binding shadows another binding if the binding occurs at a point where the other binding is visible, and the bindings have the same name. It is an error if a binding established by an xsl:variable or xsl:param element within a template shadows another binding established by an xsl:variable or xsl:param element also within the template. It is not an error if a binding established by an xsl:variable or xsl:param element in a template shadows another binding established by an xsl:variable or xsl:paramtop-level element. In this case, the top-level binding will not be visible in the region of the stylesheet where it is shadowed by the other binding. Thus, the following is an error:

<xsl:template name="foo">
<xsl:param name="x" select="1"/>
<xsl:variable name="x" select="2"/>
</xsl:template>

次は許容される： However, the following is allowed:

<xsl:param name="x" select="1"/>
<xsl:template name="foo">
<xsl:variable name="x" select="2"/>
</xsl:template>

注記： Java 言語において, テンプレート内の xsl:variable 要素と最も近い存在は、初期化子を伴う final 局所変数の宣言になる。 例えば, NOTE:The nearest equivalent in Java to an xsl:variable element in a template is a final local variable declaration with an initializer. For example,

<xsl:variable name="x" select="'value'"/>

は、次と似た意味内容になる： has similar semantics to

final Object x = "value";

ただし, XSLT には次の Java の代入演算子と等価な表記は存在しない。 XSLT does not provide an equivalent to the Java assignment operator

x = "value";

その理由は、これを取り入れると, 先頭から終わりまで間断なく続けるバッチ的手法以外に文書の処理を実装することが難しくなるためである。 because this would make it harder to create an implementation that processes a document other than in a batch-like way, starting at the beginning and continuing through to the end.

11.6 テンプレートへのパラメタの引き渡し

<xsl:with-param
  name = qname 
  select = expression>
  <!-- 内容：template -->
</xsl:with-param>

xsl:with-param 要素を通してパラメタをテンプレートに渡すことができる。 必須の name 属性に、パラメタ（束縛の値に置換される変数）の名前を指定する。 name 属性の値は QName であり, [2.4 修飾名] に則って展開される。 xsl:with-param は xsl:call-template と xsl:apply-templates の内部で利用できる。 同じ xsl:call-template または xsl:apply-templates 要素内に同じ名前の複数の xsl:with-param 要素が含まれる場合、エラーとする。 パラメタの値は xsl:variable や xsl:param の場合と同じ方法で指定する。 xsl:with-param 要素に指定された値の評価に利用される現在のノードと現在のノードリストは、 xsl:apply-templates 要素や xsl:call-template 要素の場合と同じものになる。 パラメタ x を受け取る xsl:param 要素を持たないテンプレートに、パラメタ x を渡してもエラーにはならない。 このようなパラメタは単に無視される。 Parameters are passed to templates using the xsl:with-param element. The required name attribute specifies the name of the parameter (the variable the value of whose binding is to be replaced). The value of the name attribute is a QName, which is expanded as described in [2.4 Qualified Names]. xsl:with-param is allowed within both xsl:call-template and xsl:apply-templates. It is an error if a single xsl:call-template or xsl:apply-templates element contains more than one xsl:with-param element with the same name. The value of the parameter is specified in the same way as for xsl:variable and xsl:param. The current node and current node list used for computing the value specified by xsl:with-param element is the same as that used for the xsl:apply-templates or xsl:call-template element within which it occurs. It is not an error to pass a parameter x to a template that does not have an xsl:param element for x; the parameter is simply ignored.

次の例は、数値フォーマットを制御する引数を伴う名前付きテンプレート numbered-block を定義している。 This example defines a named template for a numbered-block with an argument to control the format of the number.

<xsl:template name="numbered-block">
  <xsl:param name="format">1. </xsl:param>
  <fo:block>
    <xsl:number format="{$format}"/>
    <xsl:apply-templates/>
  </fo:block>
</xsl:template>

<xsl:template match="ol//ol/li">
  <xsl:call-template name="numbered-block">
    <xsl:with-param name="format">a. </xsl:with-param>
  </xsl:call-template>
</xsl:template>

12.1 複数のソース文書

関数： node-set document ( object, node-set?) Function: node-set document(object, node-set?)

document 関数は、メインのソース文書以外の XML 文書へのアクセスを可能にする。 The document function allows access to XML documents other than the main source document.

【第１引数がノード集合の場合の結果は第１引数が文字列の場合の結果から定義される】 document 関数の引数が１個だけで, その引数がノード集合だった場合、その結果は, 引数のノード集合に含まれる各ノードに対し、ノードの 文字列値 を第１引数に, そのノードを唯一のメンバとするノード集合を第２引数にして document 関数を呼び出した結果の和集合をとったものになる。 document 関数の引数が２個あり, 第１引数がノード集合だった場合、その結果は, 引数のノード集合に含まれる各ノードに対し、ノードの 文字列値 を第１引数に, 第２引数を document 関数に渡された第２引数にして document 関数を呼び出した結果の和集合をとったものになる。 When the document function has exactly one argument and the argument is a node-set, then the result is the union, for each node in the argument node-set, of the result of calling the document function with the first argument being the string-value of the node, and the second argument being a node-set with the node as its only member. When the document function has two arguments and the first argument is a node-set, then the result is the union, for each node in the argument node-set, of the result of calling the document function with the first argument being the string-value of the node, and with the second argument being the second argument passed to the document function.

document 関数に指定した第１引数がノード集合でない場合、第１引数は string 関数を呼び出したかのように文字列に変換される。 この文字列は URI 参照として扱われ, まず この URI が参照するリソースが取得される。 取得された結果のデータは XML 文書として構文解析され, データモデルに従ってツリーが構築される（ [3 データモデル] を見よ）。 リソースの取得時にエラーが生じた場合、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、空のノード集合を返してエラーから回復しなければならない。 リソース取得時のエラーとしては XSLT プロセッサが URI のスキーマをサポートしていないなどが挙げられる。 XSLT プロセッサには特定の URI スキーマのサポートは要求されていないが、実装側は XSLT プロセッサの説明書においてどの URI スキーマをサポートしているかを示すべきである。 When the first argument to the document function is not a node-set, the first argument is converted to a string as if by a call to the string function. This string is treated as a URI reference; the resource identified by the URI is retrieved. The data resulting from the retrieval action is parsed as an XML document and a tree is constructed in accordance with the data model (see [3 Data Model]). If there is an error retrieving the resource, then the XSLT processor may signal an error; if it does not signal an error, it must recover by returning an empty node-set. One possible kind of retrieval error is that the XSLT processor does not support the URI scheme used by the URI. An XSLT processor is not required to support any particular URI schemes. The documentation for an XSLT processor should specify which URI schemes the XSLT processor supports.

URI 参照が素片識別子を含まない場合、文書のルートノードのみからなるノード集合が返される。 URI 参照が素片識別子を含む場合、この関数は URI 参照の素片識別子から特定されるツリー内のノード集合を返す。 素片識別子の意味内容は、 URI による取得結果のメディア型から決定される。 素片識別子の処理過程でエラーが発生した場合、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、空のノード集合を返してエラーから回復しなければならない。 生じ得るエラーには次のものが挙げられる： If the URI reference does not contain a fragment identifier, then a node-set containing just the root node of the document is returned. If the URI reference does contain a fragment identifier, the function returns a node-set containing the nodes in the tree identified by the fragment identifier of the URI reference. The semantics of the fragment identifier is are dependent on the media type of the result of retrieving the URI. If there is an error in processing the fragment identifier, the XSLT processor may signal the error; if it does not signal the error, it must recover by returning an empty node-set. Possible errors include:

• 素片識別子が XSLT のノード集合では表現できないものを指している（テキストノード内のある範囲の文字など）。 The fragment identifier identifies something that cannot be represented by an XSLT node-set (such as a range of characters within a text node).

• 取得結果のメディア型の素片識別子を XSLT プロセッサがサポートしていない。 XSLT プロセッサには、特定のメディア型のサポートは要求されていないが、実装側は XSLT プロセッサの説明書においてメディア型の素片識別子をサポートしているかを示すべきである。 The XSLT processor does not support fragment identifiers for the media-type of the retrieval result. An XSLT processor is not required to support any particular media types. The documentation for an XSLT processor should specify for which media types the XSLT processor supports fragment identifiers.

メディア型に関わらず、取得結果のデータは XML 文書として構文解析される。 構文解析においては, トップレベルメディア型が text だった場合、メディア型を text/xml とみなした上で行い, それ以外の場合、メディア型を application/xml とみなした上で行うものとする。 The data resulting from the retrieval action is parsed as an XML document regardless of the media type of the retrieval result; if the top-level media type is text, then it is parsed in the same way as if the media type were text/xml; otherwise, it is parsed in the same way as if the media type were application/xml.

注記： トップレベルの xml メディア型は存在しないため, text/xml または application/xml 以外のメディア型のデータでも、実際は XML になっていることがある。 NOTE:Since there is no top-level xml media type, data with a media type other than text/xml or application/xml may in fact be XML.

URI 参照は相対 URI にもなり得る。 この場合、相対 URI の解決に用いる基底 URI （ [3.2 基底 URI] を見よ）は、第２引数のノード集合に含まれるノードのうち, 文書順で最初のノードの基底 URI とする。 URI 参照が相対 URI にもかかわらず第２引数のノード集合が空だった場合、エラーとする。 この場合、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、空のノード集合を返して, エラーから回復しなければならない。 第２引数が省略された場合、 document 関数の呼び出しを含む式を含んでいるスタイルシート内のノードの基底 URI を既定のものとして利用するものとする。 長さゼロの URI 参照は、解決対象の URI 参照に相対的な文書への参照になることに注意。 従って document("") は、スタイルシートのルートノードを参照することになり, そのツリー表現は、そのスタイルシートを含む XML 文書を, ソース文書としてあてがったときと全く同じになる。 The URI reference may be relative. The base URI (see [3.2 Base URI]) of the node in the second argument node-set that is first in document order is used as the base URI for resolving the relative URI into an absolute URI. It is an error if the second argument node-set is empty and the URI reference is relative; the XSLT processor may signal the error; if it does not signal an error, it must recover by returning an empty node-set. If the second argument is omitted, then it defaults to the node in the stylesheet that contains the expression that includes the call to the document function. Note that a zero-length URI reference is a reference to the document relative to which the URI reference is being resolved; thus document("") refers to the root node of the stylesheet; the tree representation of the stylesheet is exactly the same as if the XML document containing the stylesheet was the initial source document.

同一の URI から取得された文書は、同一の文書として扱われる。 識別時の比較に用いる URI においては、相対 URI は絶対 URI に解決されるものとし, かつ 素片識別子は含まないものとする。 ２つのルートノードが同一の文書からのものであった場合、同一のノードとして扱われる。 従って, 次の式は常に真になる。 Two documents are treated as the same document if they are identified by the same URI. The URI used for the comparison is the absolute URI into which any relative URI was resolved and does not include any fragment identifier. One root node is treated as the same node as another root node if the two nodes are from the same document. Thus, the following expression will always be true:

generate-id(document("foo.xml"))=generate-id(document("foo.xml"))

document 関数の利用においては、ノード集合は複数の文書からのノードを含み得る。 このようなノード集合においては, 同一の文書からの２つのノードの相対的な文書順は、 XPath [XPath] で定められる通常の 文書順 とし, 異なる文書からの２つのノードの相対的な文書順は、それらの文書の実装依存の順序付けに従うものとする。 複数の文書の順序付けについては、一貫性のある順序付けを行わなければならないこと以外に制約はない。 すなわち, 実装は、同じ文書集合に対し常に同じ順序を与えなければならない。 The document function gives rise to the possibility that a node-set may contain nodes from more than one document. With such a node-set, the relative document order of two nodes in the same document is the normal document order defined by XPath [XPath]. The relative document order of two nodes in different documents is determined by an implementation-dependent ordering of the documents containing the two nodes. There are no constraints on how the implementation orders documents other than that it must do so consistently: an implementation must always use the same order for the same set of documents.

12.2 キー

キーを利用すると、暗黙的な相互参照構造を持つ文書を扱えるようになる。 XML の属性型 ID, IDREF, IDREFS は、 XML 文書の相互参照を明示的に利用可能にする仕組みを提供する。 XSLT は XPath の id 関数を利用してこの仕組みをサポートする。 しかしながら、この仕組みには以下に挙げるようないくつもの制約がある。 Keys provide a way to work with documents that contain an implicit cross-reference structure. The ID, IDREF and IDREFS attribute types in XML provide a mechanism to allow XML documents to make their cross-reference explicit. XSLT supports this through the XPath id function. However, this mechanism has a number of limitations:

• ID 型の属性は、 DTD 内で ID 型の属性として宣言されていなければならない。 ある ID 型の属性が, 外部 DTD サブセットの内部だけで宣言されている場合、その ID 型の属性は XML プロセッサがその外部 DTD サブセットを読み込んだ場合に限り、 ID 型として認識される。 しかしながら, XML の仕様では XML プロセッサに対する外部 DTD の読み込みは要求されていない。 特に, 文書において standalone="yes" が宣言されている場合、外部 DTD の読み込みを行わないふるまいも十分適切になる。 ID attributes must be declared as such in the DTD. If an ID attribute is declared as an ID attribute only in the external DTD subset, then it will be recognized as an ID attribute only if the XML processor reads the external DTD subset. However, XML does not require XML processors to read the external DTD, and they may well choose not to do so, especially if the document is declared standalone="yes".

• 一つの文書内では、一意 ID の集合は１個までに限られ, 独立した別個の一意 ID の集合は存在できない。 A document can contain only a single set of unique IDs. There cannot be separate independent sets of unique IDs.

• 要素に ID を指定できるのは属性に限られる。 要素の内容や子要素による指定はできない。 The ID of an element can only be specified in an attribute; it cannot be specified by the content of the element, or by a child element.

• ID は XML 名でなければならない。 例えばスペースが含まれてはならない。 An ID is constrained to be an XML name. For example, it cannot contain spaces.

• 要素が持てる ID は１個までに限られる。 An element can have at most one ID.

• 同じ ID を持てる要素は１個までに限られる。 At most one element can have a particular ID.

これらの制約のため、 XML 文書には明示的に ID, IDREF, IDREFS 型の属性で宣言されないような相互参照構造を含むものがある。 Because of these limitations XML documents sometimes contain a cross-reference structure that is not explicitly declared by ID/IDREF/IDREFS attributes.

キーは次の三つ組からなる： A key is a triple containing:

1. キーを持つノード the node which has the key

2. キーの名前（ 展開名 ） the name of the key (an expanded-name)

3. キーの値（文字列） the value of the key (a string)

スタイルシートは、xsl:key 要素を用いて各文書ごとにキーの集合を宣言する。 以下, この集合に属するキーがノード x, 名前 y, 値 z を持つとき、ノード x は名前 y, 値 z のキーを持つ, と表現することにする。 A stylesheet declares a set of keys for each document using the xsl:key element. When this set of keys contains a member with node x, name y and value z, we say that node x has a key with name y and value z.

このようにキーは ID を一般化したものなので、 XML の ID のような制約は課されない。 Thus, a key is a kind of generalized ID, which is not subject to the same limitations as an XML ID:

• キーはスタイルシートの中で xsl:key 要素を用いて宣言する。 Keys are declared in the stylesheet using xsl:key elements.

• １個のキーは１個の名前と１個の値を持つ。 キーの各名前は、独立した別個の識別子の空間を区別するものと見なせる。 A key has a name as well as a value; each key name may be thought of as distinguishing a separate, independent space of identifiers.

• 要素に対する名前付きキーの値は、例えば, 属性の中, 子要素の中, 内容の中など、任意に都合のいい場所に指定できる。 XPath 式を名前付きキーの値の位置の指定に利用する。 The value of a named key for an element may be specified in any convenient place; for example, in an attribute, in a child element or in content. An XPath expression is used to specify where to find the value for a particular named key.

• キーの値は、名前でなくともよく, 任意の文字列が可能である。 The value of a key can be an arbitrary string; it is not constrained to be a name.

• 同じ文書内に、同じノード, 同じ名前を持ち, 異なる値を持つキーを複数含められる。 There can be multiple keys in a document with the same node, same key name, but different key values.

• 同じ文書内に、同じ名前, 同じ値を持ち, 異なるノードを持つキーを複数含められる。 There can be multiple keys in a document with the same key name, same key value, but different nodes.

<!-- Category:
top-level-element -->
<xsl:key
  name = qname
         match = pattern
         use = expression />

キーの宣言には xsl:key 要素を利用する。 name 属性の値（以下これを y とする）にキーの名前を指定する。 値は QName であり, [2.4 修飾名] に則って展開される。 match 属性の値は Pattern である。 xsl:key 要素は match 属性に指定されたパターンに合致するすべてのノードに対し、それらのキーの情報を提供するものになる。 use 属性はキーの値を指定する 式 である。 この式はパターンに合致したノード（ x とする）ごとに１度ずつ評価される。 その結果がノード集合の場合、 x は結果の各ノードごとに, その文字列値を値とする名前 y のキーを持つ。 他の場合、結果は文字列に変換され, x はその文字列を値とする名前 y のキーを持つ。 すなわち, xsl:key 要素が次の条件を満たす場合、そのときに限り, ノード x に名前 y , 値 z を持つキーが存在する。 The xsl:key element is used to declare keys. The name attribute specifies the name of the key. The value of the name attribute is a QName, which is expanded as described in [2.4 Qualified Names]. The match attribute is a Pattern; an xsl:key element gives information about the keys of any node that matches the pattern specified in the match attribute. The use attribute is an expression specifying the values of the key; the expression is evaluated once for each node that matches the pattern. If the result is a node-set, then for each node in the node-set, the node that matches the pattern has a key of the specified name whose value is the string-value of the node in the node-set; otherwise, the result is converted to a string, and the node that matches the pattern has a key of the specified name with value equal to that string. Thus, a node x has a key with name y and value z if and only if there is an xsl:key element such that:

• x が xsl:key 要素の match 属性に指定されたパターンに合致する。 x matches the pattern specified in the match attribute of the xsl:key element;

• xsl:key 要素の name 属性の値が y に等しい。 the value of the name attribute of the xsl:key element is equal to y; and

• x を現在のノードに, x のみからなるノードリストを現在のノードリストにして xsl:key 要素の use 属性に指定された式を評価した結果のオブジェクトを u とする。 このとき, string 関数を呼び出したかのように u を文字列に変換した結果が z に等しくなるか, または u がノード集合で z が u の中のどれかのノードの文字列値に等しい。 when the expression specified in the use attribute of the xsl:key element is evaluated with x as the current node and with a node list containing just x as the current node list resulting in an object u, then either z is equal to the result of converting u to a string as if by a call to the string function, or u is a node-set and z is equal to the string-value of one or more of the nodes in u.

ノードに合致する xsl:key 要素は複数存在し得ることに注意。 要素の インポート優先順位 が異なっていても、合致する xsl:key 要素はすべて利用される。 Note also that there may be more than one xsl:key element that matches a given node; all of the matching xsl:key elements are used, even if they do not have the same import precedence.

use 属性または match 属性のいずれかの値が VariableReference を含む , または key 関数を呼び出した 場合、エラーとする。 It is an error for the value of either the use attribute or the match attribute to contain a VariableReference , or a call to the key function .

関数： node-set key ( string, object ) Function: node-set key(string, object)

key 関数は、 ID に対し id 関数が実行することをキーに対して実行する。 第１引数にはキーの名前を指定する。 この引数の値は QName でなければならない。 この値は [2.4 修飾名] に則って展開される。 key 関数の第２引数がノード集合の場合、それに属する各ノードに対し, その 文字列値 を第２引数として key 関数を呼び出した結果の和集合が返される。 key 関数の第２引数が他の型の場合、 string 関数を呼び出したかのように文字列に変換し, 文脈ノードと同じ文書に含まれるノードのうち, 第１引数の名前とこの文字列に等しい値のキーを持つものからなるノード集合が返される。 The key function does for keys what the id function does for IDs. The first argument specifies the name of the key. The value of the argument must be a QName, which is expanded as described in [2.4 Qualified Names]. When the second argument to the key function is of type node-set, then the result is the union of the result of applying the key function to the string-value of each of the nodes in the argument node-set. When the second argument to key is of any other type, the argument is converted to a string as if by a call to the string function; it returns a node-set containing the nodes in the same document as the context node that have a value for the named key equal to this string.

例えば次の宣言： For example, given a declaration

<xsl:key name="idkey" match="div" use="@id"/>

において, 式 key("idkey",@ref) は、 XML ソース文書に宣言されている唯一の ID 型の属性が次のもの： an expression key("idkey",@ref) will return the same node-set as id(@ref), assuming that the only ID attribute declared in the XML source document is:

<!ATTLIST div id ID #IMPLIED>

で, かつ 現在のノードの ref 属性に空白が含まれていなければ、 id(@ref) と同じノード集合を返す。 and that the ref attribute of the current node contains no whitespace.

関数ライブラリを記述する文書があって, 次のように prototype 要素を用いて関数を定義しているとする： Suppose a document describing a function library uses a prototype element to define functions

<prototype name="key" return-type="node-set">
<arg type="string"/>
<arg type="object"/>
</prototype>

更に, function 要素があって次のように関数名を参照しているとする： and a function element to refer to function names

<function>key</function>

このとき, 次ようなスタイルシートで、参照と定義の間にハイパーリンクを生成できる： Then the stylesheet could generate hyperlinks between the references and definitions as follows:

<xsl:key name="func" match="prototype" use="@name"/>

<xsl:template match="function">
<b>
  <a href="#{generate-id(key('func',.))}">
    <xsl:apply-templates/>
  </a>
</b>
</xsl:template>

<xsl:template match="prototype">
<p><a name="{generate-id()}">
<b>Function: </b>
...
</a></p>
</xsl:template>

key 関数は、常に現在のノードと同じ文書のノードの集合を返す。 他の文書からキーを取得するためには、まず現在のノードを変更しておく必要がある。 例えば <bibref>XSLT</bibref> の形式の書籍目録参照を含む文書があって, 書籍目録データベースを内容とする別の XML 文書 bib.xml に次の形式の項目が含まれているとする： The key can be used to retrieve a key from a document other than the document containing the context node. The key always returns nodes that are in the same document as the current node; to retrieve a key from any other document, it is necessary first to change the current node. For example, suppose a document contains bibliographic references in the form <bibref>XSLT</bibref>, and there is a separate XML document bib.xml containing a bibliographic database with entries in the form:

<entry name="XSLT">...</entry>

このとき, スタイルシートでは、次のようにして bibref 要素を変換できる： Then the stylesheet could use the following to transform the bibref elements:

<xsl:key name="bib" match="entry" use="@name"/>

<xsl:template match="bibref">
  <xsl:variable name="name" select="."/>
  <xsl:for-each select="document('bib.xml')">
    <xsl:apply-templates select="key('bib',$name)"/>
  </xsl:for-each>
</xsl:template>

12.3 数値のフォーマット化

関数： string format-number ( number, string, string ? ) Function: string format-number(number, string, string?)

format-number 関数は、第２引数で与えられたフォーマットパターン文字列と第３引数で与えられた名前の十進フォーマット（ decimal-format ）を利用して, 第１引数を文字列に変換する。 第３引数が指定されていない場合、既定の十進フォーマットが利用される。 フォーマットパターン文字列の構文は、 JDK 1.1 の DecimalFormat クラスで規定されるものとする。 フォーマットパターン文字列は、ローカライズされた記法で表記される。 十進フォーマットは、パターン内で特別な意味を持つ文字を規定する（引用符はローカライズされないので, これには含まれない）。 フォーマットパターンには通貨記号（ #x00A4 ）を含めてはならない。 この通貨記号が JDK 1.1 の初期リリース版以後にサポートされるようになったためである。 十進フォーマットの名前は QName でなければならない。 この値は [2.4 修飾名] に則って展開される。 スタイルシートが, 指定された 展開名 を持つ十進フォーマットの宣言を含まない場合、エラーとする。 The format-number function converts its first argument to a string using the format pattern string specified by the second argument and the decimal-format named by the third argument, or the default decimal-format, if there is no third argument. The format pattern string is in the syntax specified by the JDK 1.1 DecimalFormat class. The format pattern string is in a localized notation: the decimal-format determines what characters have a special meaning in the pattern (with the exception of the quote character, which is not localized). The format pattern must not contain the currency sign (#x00A4); support for this feature was added after the initial release of JDK 1.1. The decimal-format name must be a QName, which is expanded as described in [2.4 Qualified Names]. It is an error if the stylesheet does not contain a declaration of the decimal-format with the specified expanded-name.

注記： XSLT の実装には JDK 1.1 の実装の利用は要求されていないし, XSLT を Java で実装することも要求されていない。 NOTE:Implementations are not required to use the JDK 1.1 implementation, nor are implementations required to be implemented in Java.

注記： スタイルシートは、数値の丸め方の制御に XPath のその他の機能を利用できる。 NOTE:Stylesheets can use other facilities in XPath to control rounding.

<!-- 分類：top-level-element -->
<xsl:decimal-format
  name = qname 
  decimal-separator = char 
  grouping-separator = char 
  infinity = string 
  minus-sign = char 
  NaN = string 
  percent = char 
  per-mille = char 
  zero-digit = char 
  digit = char 
  pattern-separator = char />

xsl:decimal-format 要素は、十進フォーマットを宣言して format-number 関数が利用するフォーマットパターンの解釈を制御する。 要素に name 属性が与えられた場合、名前付きの十進フォーマットを宣言する。 他の場合、既定の十進フォーマットを宣言する。 name 属性の値は QName であり, [2.4 修飾名] に則って展開される。 既定の十進フォーマットまたは同じ名前の十進フォーマットが（ インポート優先順位 に関わらず）複数回宣言された場合、それらの（すべての既定値も含めた）すべての属性値が同じになる場合を除き, エラーとする。 スタイルシートに既定の十進フォーマットの宣言が与えられていない場合、属性を持たない xsl:decimal-format 要素と等価な宣言が既定のものとして利用されるものとする。 The xsl:decimal-format element declares a decimal-format, which controls the interpretation of a format pattern used by the format-number function. If there is a name attribute, then the element declares a named decimal-format; otherwise, it declares the default decimal-format. The value of the name attribute is a QName, which is expanded as described in [2.4 Qualified Names]. It is an error to declare either the default decimal-format or a decimal-format with a given name more than once (even with different import precedence), unless it is declared every time with the same value for all attributes (taking into account any default values). If a stylesheet does not contain a declaration of the default decimal format, a declaration equivalent to an xsl:decimal-format element with no attributes is implied.

xsl:decimal-format の他の属性は、 JDK 1.1 の DecimalFormatSymbols クラスが提供するメソッドに対応している。 xsl:decimal-format 要素には、このクラスの get, set メソッドの各ペアに対応する属性が定義されている。 The other attributes on xsl:decimal-format correspond to the methods on the JDK 1.1 DecimalFormatSymbols class. For each get/set method pair there is an attribute defined for the xsl:decimal-format element.

次に挙げる属性は、フォーマットパターンに含まれる文字の解釈を制御するとともに, 数値のフォーマット結果に現れる文字を規定する。 The following attributes both control the interpretation of characters in the format pattern and specify characters that may appear in the result of formatting the number:

• decimal-separator は、小数点記号として利用する文字を指定する。 既定値はピリオド（ . ）。 decimal-separator specifies the character used for the decimal sign; the default value is the period character (.)

• grouping-separator は、グループ化（例えば 1000 単位）の区切り記号に用いる文字を指定する。 既定値はコンマ（ , ）。 grouping-separator specifies the character used as a grouping (e.g. thousands) separator; the default value is the comma character (,)

• percent は、パーセント記号に用いる文字を指定する。 既定値はパーセント（ % ）。 percent specifies the character used as a percent sign; the default value is the percent character (%)

• per-mille は、パーミル（千分率）記号に用いる文字を指定する。 既定値は Unicode のパーミル文字（ #x2030 ）。 per-mille specifies the character used as a per mille sign; the default value is the Unicode per-mille character (#x2030)

• zero-digit は、数表記用数字のゼロに使う文字を指定する。 既定値は数表記用数字のゼロ（ 0 ）。 zero-digit specifies the character used as the digit zero; the default value is the digit zero (0)

次に挙げる属性は、フォーマットパターンに含まれる文字の解釈を制御する。 The following attributes control the interpretation of characters in the format pattern:

• digit は、フォーマットパターンに含まれる数字の表記に用いる文字を指定する。 既定値は番号記号（ # ）。 digit specifies the character used for a digit in the format pattern; the default value is the number sign character (#)

• pattern-separator は、パターン内の正の部分パターンと負の部分パターンの区切りに用いる文字を指定する。 既定値はセミコロン（ ; ）。 pattern-separator specifies the character used to separate positive and negative sub patterns in a pattern; the default value is the semi-colon character (;)

次に挙げる属性は、数値をフォーマットした結果に現れる文字または文字列を指定する。 The following attributes specify characters or strings that may appear in the result of formatting the number:

• infinity は、無限大の表記に用いる文字列を指定する。 既定値は文字列 Infinity 。 infinity specifies the string used to represent infinity; the default value is the string Infinity

• NaN は、 NaN 型の値の表記に用いる文字列を指定する。 既定値は文字列 NaN 。 NaN specifies the string used to represent the NaN value; the default value is the string NaN

• minus-sign は、負符号の表記に用いる既定の文字を指定する。 既定値はハイフンマイナス（ -, #x2D ）。 minus-sign specifies the character used as the default minus sign; the default value is the hyphen-minus character (-, #x2D)

12.4 その他の追加の関数

関数： node-set current() Function: node-set current()

current 関数は、 現在のノード のみからなるノード集合を返す。 最も外側の式（他の式の内部に現れない式）においては、現在のノードは常に文脈ノードと同じになる。 従って, The current function returns a node-set that has the current node as its only member. For an outermost expression (an expression not occurring within another expression), the current node is always the same as the context node. Thus,

<xsl:value-of select="current()"/>

は、次と同じ意味になる。 means the same as

<xsl:value-of select="."/>

しかしながら, 角括弧内では、通常, 現在のノードと文脈ノードは異なる。 例えば： However, within square brackets the current node is usually different from the context node. For example,

<xsl:apply-templates select="//glossary/item[@name=current()/@ref]"/>

は、親要素が glossary, かつ name 属性の値が現在のノードの ref 属性の値と等しい, すべての item 要素を処理する。 これは次とは異なる： will process all item elements that have a glossary parent element and that have a name attribute with value equal to the value of the current node's ref attribute. This is different from

<xsl:apply-templates select="//glossary/item[@name=./@ref]"/>

これは次と同じ意味になる： which means the same as

<xsl:apply-templates select="//glossary/item[@name=@ref]"/>

この場合, 親要素が glossary, かつ name 属性と ref 属性の値が等しい, すべての item 要素を処理することになる。 and so would process all item elements that have a glossary parent element and that have a name attribute and a ref attribute with the same value.

パターン 内の current 関数の利用は、エラーとする。 It is an error to use the current function in a pattern.

関数： string unparsed-entity-uri ( string ) Function: string unparsed-entity-uri(string)

unparsed-entity-uri 関数は、文脈ノードと同じ文書に含まれる, 引数に指定された名前の解析対象外実体の URI を返す （ [3.3 解析対象外実体] を見よ）。 該当する解析対象外実体が存在しない場合、空文字列を返す。 The unparsed-entity-uri returns the URI of the unparsed entity with the specified name in the same document as the context node (see [3.3 Unparsed Entities]). It returns the empty string if there is no such entity.

関数： string generate-id ( node-set?) Function: string generate-id(node-set?)

generate-id 関数は、引数に指定されたノード集合の中から, 文書順で最初のノードを一意的に識別する文字列を返す。 この識別子は ASCII の英数文字からなり, 先頭の文字はアルファベットでなければならない。 従って, この文字列は構文上は XML 名になる。 実装は、同じノードには常に同じ識別子を生成し, 異なるノードには常に異なる識別子を生成する限り, どのような方法で識別子を生成してもよい。 実装は、文書が変換されるごとに同じ識別子を生成する義務はない。 生成される一意的な識別子が、ソース文書内の一意 ID とは別個になる保証はない。 引数に指定されたノード集合が空の場合、空文字列を返す。 引数が省略された場合、文脈ノードが既定の引数として利用される。 The generate-id function returns a string that uniquely identifies the node in the argument node-set that is first in document order. The unique identifier must consist of ASCII alphanumeric characters and must start with an alphabetic character. Thus, the string is syntactically an XML name. An implementation is free to generate an identifier in any convenient way provided that it always generates the same identifier for the same node and that different identifiers are always generated from different nodes. An implementation is under no obligation to generate the same identifiers each time a document is transformed. There is no guarantee that a generated unique identifier will be distinct from any unique IDs specified in the source document. If the argument node-set is empty, the empty string is returned. If the argument is omitted, it defaults to the context node.

関数： object system-property ( string ) Function: object system-property(string)

引数は QName の文字列に評価されなければならない。その QName は、式のスコープに含まれる名前空間宣言を用いて名前に展開される。 system-property 関数は、その名前で識別されるシステムプロパティの値を表すオブジェクトを返す。 システムプロパティが存在しない場合、空文字列を返すべきである。 The argument must evaluate to a string that is a QName. The QName is expanded into a name using the namespace declarations in scope for the expression. The system-property function returns an object representing the value of the system property identified by the name. If there is no such system property, the empty string should be returned.

実装は、次に挙げるシステムプロパティを提供しなければならない。 これらはすべて XSLT 名前空間に属する： Implementations must provide the following system properties, which are all in the XSLT namespace:

• xsl:version。 XSLT プロセッサに実装されている XSLT のバージョンを示す数値。 この文書で規定している XSLT のバージョンを実装した XSLT プロセッサの場合、これは 1.0 になる。 xsl:version, a number giving the version of XSLT implemented by the processor; for XSLT processors implementing the version of XSLT specified by this document, this is the number 1.0

• xsl:vendor。 XSLT プロセッサのベンダを識別する文字列。 xsl:vendor, a string identifying the vendor of the XSLT processor

• xsl:vendor-url。 XSLT プロセッサのベンダを識別する URL を含む文字列。 通常はベンダのウェブサイトのホストページ （ホームページ）になる。 xsl:vendor-url, a string containing a URL identifying the vendor of the XSLT processor; typically this is the host page (home page) of the vendor's Web site.

ベンダは XSLT 名前空間に属する追加のシステムプロパティを定義してはならない。 Vendors must not define additional system properties in the XSLT namespace.

14.1 拡張要素

要素を拡張する仕組みにより、名前空間を 拡張名前空間 に指定できる（以下「拡張指定」）。 名前空間が拡張指定にされると, その名前空間に属する名前の要素は、テンプレートの中ではリテラル結果要素としてではなく, 命令として扱われる。 この名前空間は、命令の意味内容を定める。 The element extension mechanism allows namespaces to be designated as extension namespaces. When a namespace is designated as an extension namespace and an element with a name from that namespace occurs in a template, then the element is treated as an instruction rather than as a literal result element. The namespace determines the semantics of the instruction.

注記： xsl:stylesheet 要素の子要素はテンプレートの内部の要素ではないので, 非 XSLT の トップレベル の要素は、ここで定義する拡張要素には該当せず, この節の内容は全て適用されない。 NOTE:Since an element that is a child of an xsl:stylesheet element is not occurring in a template, non-XSLT top-level elements are not extension elements as defined here, and nothing in this section applies to them.

名前空間を拡張指定にするためには、 xsl:stylesheet 要素に extension-element-prefixes 属性を与えるか, リテラル結果要素または拡張要素に xsl:extension-element-prefixes 属性を与える。 これらの属性の値は、いずれも名前空間接頭辞の空白区切りのリストである。 各接頭辞に結びつけられた名前空間が、拡張指定にされる。 extension-element-prefixes 属性または xsl:extension-element-prefixes 属性を持つ要素のスコープに, これらの接頭辞に結びつけられた名前空間が存在しない場合、エラーとする。 名前空間接頭辞のリストに #default を含めることにより, 既定の名前空間（ xmlns で宣言されたもの）を拡張指定にしてもよい。 名前空間の拡張指定は、 extension-element-prefixes 属性または xsl:extension-element-prefixes 属性を持つ要素をルートとするスタイルシートの部分ツリーの中で有効になる。 xsl:stylesheet 要素をルートとする部分ツリーでは、その xsl:stylesheet 要素の子によりインポートまたはインクルードされたスタイルシートには指定の効力は及ばない。 A namespace is designated as an extension namespace by using an extension-element-prefixes attribute on an xsl:stylesheet element or an xsl:extension-element-prefixes attribute on a literal result element or extension element. The value of both these attributes is a whitespace-separated list of namespace prefixes. The namespace bound to each of the prefixes is designated as an extension namespace. It is an error if there is no namespace bound to the prefix on the element bearing the extension-element-prefixes or xsl:extension-element-prefixes attribute. The default namespace (as declared by xmlns) may be designated as an extension namespace by including #default in the list of namespace prefixes. The designation of a namespace as an extension namespace is effective within the subtree of the stylesheet rooted at the element bearing the extension-element-prefixes or xsl:extension-element-prefixes attribute; a subtree rooted at an xsl:stylesheet element does not include any stylesheets imported or included by children of that xsl:stylesheet element.

XSLT プロセッサが特定の拡張要素に対応する実装を備えていない場合、 element-available 関数はその要素の名前に対し, 偽を返さなければならない。 そのような拡張要素がインスタンス化される際は、 XSLT プロセッサは [15 フォールバック] に則って, その要素に対するフォールバックを実行しなければならない。 XSLT プロセッサは、単に実装が対応しない拡張要素がテンプレートに含まれているだけの理由でエラーを通知してはならない。 If the XSLT processor does not have an implementation of a particular extension element available, then the element-available function must return false for the name of the element. When such an extension element is instantiated, then the XSLT processor must perform fallback for the element as specified in [15 Fallback]. An XSLT processor must not signal an error merely because a template contains an extension element for which no implementation is available.

XSLT プロセッサの実装が特定の拡張要素に対応している場合、 element-available 関数はその要素の名前に対し, 真を返さなければならない。 If the XSLT processor has an implementation of a particular extension element available, then the element-available function must return true for the name of the element.

14.2 拡張関数

式 FunctionCall （関数呼び出しの生成規則）に含まれる FunctionName （関数名）が NCName でない場合（すなわちコロンが含まれる）、この FunctionName は拡張関数の呼び出しとして扱われる。 この FunctionName は評価文脈のスコープに入る名前空間宣言を用いて名前に展開される。 If a FunctionName in a FunctionCall expression is not an NCName (i.e. if it contains a colon), then it is treated as a call to an extension function. The FunctionName is expanded to a name using the namespace declarations from the evaluation context.

XSLT プロセッサの実装が特定の名前の拡張関数に対応していない場合、 function-available 関数はその名前に対し, 偽を返さなければならない。 そのような拡張関数が式に現れ, 実際に呼び出された場合、 XSLT プロセッサはエラーを通知しなければならない。 XSLT プロセッサは、実装が対応しない拡張関数が式に含まれているだけの理由でエラーを通知してはならない。 If the XSLT processor does not have an implementation of an extension function of a particular name available, then the function-available function must return false for that name. If such an extension function occurs in an expression and the extension function is actually called, the XSLT processor must signal an error. An XSLT processor must not signal an error merely because an expression contains an extension function for which no implementation is available.

XSLT プロセッサの実装が特定の名前の拡張関数に対応している場合、 function-available 関数はその名前に対し、真を返さなければならない。 そのような拡張機能が呼び出された場合、 XSLT プロセッサは関数呼び出しの引数を渡して実装を呼び出さなければならない。 実装から返された結果が、その関数呼び出しの結果として返される。 If the XSLT processor has an implementation of an extension function of a particular name available, then the function-available function must return true for that name. If such an extension is called, then the XSLT processor must call the implementation passing it the function call arguments; the result returned by the implementation is returned as the result of the function call.

16.1 XML 出力メソッド

xml 出力メソッドは、結果ツリーを整形式 XML の外部一般解析対象実体として出力する。 結果ツリーのルートノードが、１個の要素を子に持ち, テキストノードは１個も子に持たない場合、この実体は整形式 XML 文書にもなる。 そのような実体が、次のような小さな XML 文書ラッパー： The xml output method outputs the result tree as a well-formed XML external general parsed entity. If the root node of the result tree has a single element node child and no text node children, then the entity should also be a well-formed XML document entity. When the entity is referenced within a trivial XML document wrapper like this

<?xml version="xml-version"?>
<!DOCTYPE doc [
<!ENTITY e SYSTEM "entity-URI">
]>
<doc>&e;</doc>

から参照されている場合（ ここで entity-URI は実体の URI , xml-version は実体に対応する XML のバージョン を表すとする）、ラッパー文書は [XML Names] または [XML Names 1.1] に適合する整形式 XML 文書になるべきである。 加えて, 出力に対しては、ラッパーを [3 データモデル] に則って XML 文書として構文解析し, 文書要素の子要素をルートノードの子にそっくり移し替えて出来上がるツリーが、以下に挙げる例外を除いて結果ツリーと同じになるべきである： where entity-URI is a URI for the entity and xml-version corresponds to the XML version of the entity , then the wrapper document as a whole should be a well-formed XML document conforming to the XML Namespaces Recommendation [XML Names]. either to [XML Names] or [XML Names 1.1]. In addition, the output should be such that if a new tree was constructed by parsing the wrapper as an XML document as specified in [3 Data Model], and then removing the document element, making its children instead be children of the root node, then the new tree would be the same as the result tree, with the following possible exceptions:

• ２つのツリーに含まれる属性 と名前空間ノード の順序は異なってもよい。 The order of attributes and namespace nodes in the two trees may be different.

• 新しいツリーは、結果ツリーに存在しない名前空間ノードを含んでもよい。 The new tree may contain namespace nodes that were not present in the result tree.

  注記： XSLT プロセッサは、結果ツリーを XML として出力する際に名前空間宣言を追加する必要も生じ得る。 NOTE:An XSLT processor may need to add namespace declarations in the course of outputting the result tree as XML.

• ２つのツリーのノードの基底 URI は異なってもよい。 The base URIs of nodes in the two trees may be different.

XSLT プロセッサが doctype-system 属性の指定により文書型宣言を生成する場合, あるいは standalone 属性の指定によりスタンドアロン文書宣言を生成する場合、出力は整形式 XML 文書でなければならず, 上の要件は DTD を処理しない XML プロセッサを用いて出力文書をラッパ無しに直接構文解析することにより構築されるツリーに適用される。 If the XSLT processor generated a document type declaration because of the doctype-system attribute, then the above requirements apply to the entity with the generated document type declaration removed. If the XSLT processor generated a document type declaration because of the doctype-system attribute or generated a standalone document declaration because of the standalone attribute, then the output must be a well-formed XML document, and the above requirements apply to the tree constructed by parsing that document directly, without any wrapper, using an XML processor that does not process the DTD.

注記： DTD の処理が行われる場合、属性の既定値により, ツリー内に追加の属性が現れ得る。 NOTE:Processing the DTD might cause additional attributes to appear in the tree because of attribute defaulting.

version 属性は、結果ツリーの出力に利用される XML のバージョンを指定する。 XSLT プロセッサは, このバージョンをサポートしない場合、サポートするバージョンを利用すべきである。 XML 宣言が出力される場合、宣言内に出力されるバージョンは, XSLT プロセッサが結果ツリーの出力に利用したバージョンに対応するものにすべきである。 既定値は 1.0 。 値が 1.1 で XSLT プロセッサが XML 1.1 と XML Names 1.1 をともにサポートする場合、次の制約が課せられる： The version attribute specifies the version of XML to be used for outputting the result tree. If the XSLT processor does not support this version of XML, it should use a version of XML that it does support. The version output in the XML declaration (if an XML declaration is output) should correspond to the version of XML that the processor used for outputting the result tree. The value of the version attribute should match the VersionNum production of the XML Recommendation [XML]. The default value is 1.0. The default value is 1.0. If the value is 1.1 and the XSLT processor does support XML 1.1 and XML Names 1.1, then the following restrictions apply:

• 接頭辞の宣言取り消しが生じてはならない。 Undeclaring prefixes must not occur.

• Unicode 正規化が生じてはならない。 Unicode normalization must not occur.

encoding 属性には、結果ツリーの出力処理に望まれるエンコーディングを指定する。 XSLT プロセッサには、値 UTF-8 と UTF-16 に対するサポートが要求される。 他の値については, XSLT プロセッサが未サポートのエンコーディングが指定された場合、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、代わりに UTF-8 または UTF-16 を利用すべきである。 XSLT プロセッサは、 XML 勧告 [XML] または [XML 1.1] の生成規則 EncName に合致しない名前のエンコーディングを利用してはならない。 encoding 属性が指定されていない場合、 XSLT プロセッサは UTF-8 または UTF-16 のいずれかを利用すべきである。 結果ツリーには、 XSLT プロセッサが出力に利用するエンコーディングでは表現できない文字も含まれ得る。 この場合、 XML において文字参照が認識され得る場所に（すなわち属性ノードの値の中またはテキストノードの内部に）その文字が現れるのであれば, 文字参照として出力すべきである。 それ以外の場合（例えばその文字が要素名に現れる場合）、 XSLT プロセッサはエラーを通知すべきである。 The encoding attribute specifies the preferred encoding to use for outputting the result tree. XSLT processors are required to respect values of UTF-8 and UTF-16. For other values, if the XSLT processor does not support the specified encoding it may signal an error; if it does not signal an error it should use UTF-8 or UTF-16 instead. The XSLT processor must not use an encoding whose name does not match the EncName production of the XML Recommendation [XML] or [XML 1.1]. If no encoding attribute is specified, then the XSLT processor should use either UTF-8 or UTF-16. It is possible that the result tree will contain a character that cannot be represented in the encoding that the XSLT processor is using for output. In this case, if the character occurs in a context where XML recognizes character references (i.e. in the value of an attribute node or text node), then the character should be output as a character reference; otherwise (for example if the character occurs in the name of an element) the XSLT processor should signal an error.

indent 属性の値が yes の場合、 xml 出力メソッドは, 結果を見栄え良くインデント（字下げ）するため, 結果ツリー内の空白に（可能ならソース文書やスタイルシートから削除された空白などを基にして）空白を追加して出力してもよい。 indent 属性の値が no （既定値）の場合、空白を追加出力すべきではない。 xml 出力メソッドで利用する空白追加出力のアルゴリズムは、その出力に対し xsl:text のみを空白保持要素名の集合として [3.4 空白の削除] で述べたプロセスにより空白を削除した結果が、空白を追加出力しないときの出力に対し同じプロセスを適用した結果と一致するようなものになるべきである。 If the indent attribute has the value yes, then the xml output method may output whitespace in addition to the whitespace in the result tree (possibly based on whitespace stripped from either the source document or the stylesheet) in order to indent the result nicely; if the indent attribute has the value no, it should not output any additional whitespace. The default value is no. The xml output method should use an algorithm to output additional whitespace that ensures that the result if whitespace were to be stripped from the output using the process described in [3.4 Whitespace Stripping] with the set of whitespace-preserving elements consisting of just xsl:text would be the same when additional whitespace is output as when additional whitespace is not output.

注記： 一般に、混合内容を持つ要素型を含む文書型に indent="yes" を利用すると問題が生じ易い。 NOTE:It is usually not safe to use indent="yes" with document types that include element types with mixed content.

cdata-section-elements 属性の値は、空白区切りの QName のリストである。 これらの QName は、各 QName が現れる xsl:output 要素で有効な名前空間宣言を用いて展開名に展開される。 接頭辞を持たない QName の展開には、既定の名前空間が（存在すれば）利用される。 この展開処理は、複数の xsl:output 要素が有効な xsl:output 要素に併合される前に行われる。 テキストノードはその親の展開名がこのリストに含まれるならば CDATA セクションとして出力されるべきである。 例えば： The cdata-section-elements attribute contains a whitespace-separated list of QNames. Each QName is expanded into an expanded-name using the namespace declarations in effect on the xsl:output element in which the QName occurs; if there is a default namespace, it is used for QNames that do not have a prefix. The expansion is performed before the merging of multiple xsl:output elements into a single effective xsl:output element. If the expanded-name of the parent of a text node is a member of the list, then the text node should be output as a CDATA section. For example,

<xsl:output cdata-section-elements="example"/>

により、次のリテラル結果要素： would cause a literal result element written in the stylesheet as

<example>&lt;foo></example>

あるいは、次のリテラル結果要素： or as

<example><![CDATA[<foo>]]></example>

の出力は、いずれも次のようになる： to be output as

<example><![CDATA[<foo>]]></example>

テキストノードが文字列 ]]> を含む場合、処理中の CDATA セクションを ]] の直後で閉じ, 新たな CDATA セクションを > の直前から開始させるべきである。 例えば、スタイルシートの次のリテラル結果要素： If the text node contains the sequence of characters ]]>, then the currently open CDATA section should be closed following the ]] and a new CDATA section opened before the >. For example, a literal result element written in the stylesheet as

<example>]]&gt;</example>

の出力は、次のようになる： would be output as

<example><![CDATA[]]]]><![CDATA[>]]></example>

結果ツリーの出力に利用する文字エンコーディングで表現できない文字がテキストノードに含まれている場合、処理中の CDATA セクションをその文字の直前で閉じ, その文字を文字参照または実体参照を用いて出力し, 新たな CDATA セクションを開始してから後続の文字出力するべきである。 If the text node contains a character that is not representable in the character encoding being used to output the result tree, then the currently open CDATA section should be closed before the character, the character should be output using a character reference or entity reference, and a new CDATA section should be opened for any further characters in the text node.

cdata-section-elements 属性により CDATA セクションを用いた出力が明示的に指示されていない限り、テキストノードの出力に CDATA セクションを用いるべきではない。 CDATA sections should not be used except for text nodes that the cdata-section-elements attribute explicitly specifies should be output using CDATA sections.

omit-xml-declaration 属性の値が yes でない限り、 xml 出力メソッドは XML 宣言を出力すべきである。 XML 宣言には、バージョン情報もエンコーディング宣言も含めるべきである。 standalone 属性が指定されている場合はその属性値と同じ値のスタンドアロン文書宣言も含めるべきである。 そうでない場合、スタンドアロン文書宣言は含めるべきではない：これにより, （文書実体の先頭で記述が許されている） XML 宣言になると同時に、（外部一般解析対象実体の先頭で記述が許されている）テキスト宣言にもなるので。 The xml output method should output an XML declaration unless the omit-xml-declaration attribute has the value yes. The XML declaration should include both version information and an encoding declaration. If the standalone attribute is specified, it should include a standalone document declaration with the same value as the value as the value of the standalone attribute. Otherwise, it should not include a standalone document declaration; this ensures that it is both an XML declaration (allowed at the beginning of a document entity) and a text declaration (allowed at the beginning of an external general parsed entity).

doctype-system 属性が指定されている場合、 xml 出力メソッドは最初の要素の直前に文書型宣言を出力すべきである。 <!DOCTYPE に後続する名前は、最初の要素の名前になるべきである。 doctype-public 属性も指定されている場合、 xml 出力メソッドは PUBLIC に続けて公開識別子を出力し, 次にシステム識別子を出力すべきである。 そうでない場合、 SYSTEM に続けてシステム識別子を出力すべきである。 内部サブセットは空にすべきである。 doctype-public 属性は doctype-system 属性が指定されていない限り無視される。 If the doctype-system attribute is specified, the xml output method should output a document type declaration immediately before the first element. The name following <!DOCTYPE should be the name of the first element. If doctype-public attribute is also specified, then the xml output method should output PUBLIC followed by the public identifier and then the system identifier; otherwise, it should output SYSTEM followed by the system identifier. The internal subset should be empty. The doctype-public attribute should be ignored unless the doctype-system attribute is specified.

media-type 属性は xml 出力メソッドに適用できる。 既定の値は text/xml である。 The media-type attribute is applicable for the xml output method. The default value for the media-type attribute is text/xml.

16.2 HTML 出力メソッド

html 出力メソッドは結果ツリーを HTML として出力する。 例を次に示す。 The html output method outputs the result tree as HTML; for example,

<xsl:stylesheet version="1.0"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:output method="html"/>

<xsl:template match="/">
  <html>
   <xsl:apply-templates/>
  </html>
</xsl:template>

...

</xsl:stylesheet>

version 属性は HTML のバージョンを指示する。 既定値の 4.0 は、結果ツリーを HTML 4.0 勧告 [HTML] に適合する HTML で出力すべきであることを指定する。 The version attribute indicates the version of the HTML. The default value is 4.0, which specifies that the result should be output as HTML conforming to the HTML 4.0 Recommendation [HTML].

html 出力メソッドは、要素の展開名の名前空間 URI が null でない限り, xml 出力メソッドと異なる方法で要素を出力すべきではない。 展開名が非 null の名前空間 URI を持つ要素は、 XML として出力すべきである。 展開名の名前空間 URI が null で, 局所部が HTML 要素名と認識されない要素は、 span などの空要素でない行内要素と同じ方法で出力すべきである。 The html output method should not output an element differently from the xml output method unless the expanded-name of the element has a null namespace URI; an element whose expanded-name has a non-null namespace URI should be output as XML. If the expanded-name of the element has a null namespace URI, but the local part of the expanded-name is not recognized as the name of an HTML element, the element should output in the same way as a non-empty, inline element such as span.

html 出力メソッドは空要素の終了タグを出力すべきではない。 HTML 4.0 の空要素は、 area, base, basefont, br, col, frame, hr, img, input, isindex, link, meta, param である。 例えば, スタイルシートに <br/> あるいは <br></br> と記述された要素の出力は、 <br> にすべきである。 The html output method should not output an end-tag for empty elements. For HTML 4.0, the empty elements are area, base, basefont, br, col, frame, hr, img, input, isindex, link, meta and param. For example, an element written as <br/> or <br></br> in the stylesheet should be output as <br>.

html 出力メソッドは、文字の大小を区別せずに HTML 要素名を認識すべきである。 例えば、要素名 br, BR, Br はすべて HTML の br 要素と認識され, 終了タグなしで出力される。 The html output method should recognize the names of HTML elements regardless of case. For example, elements named br, BR or Br should all be recognized as the HTML br element and output without an end-tag.

html 出力メソッドは、script および style 要素の内容にエスケープ処理を施すべきではない。 例えば, 次の２つのリテラル結果要素： The html output method should not perform escaping for the content of the script and style elements. For example, a literal result element written in the stylesheet as

<script>if (a &lt; b) foo()</script>

or

<script><![CDATA[if (a < b) foo()]]></script>

の出力は、いずれも次になる： should be output as

<script>if (a < b) foo()</script>

html 出力メソッドでは、属性値に現れる文字 < をエスケープすべきではない。 The html output method should not escape < characters occurring in attribute values.

indent 属性の値が yes （既定値）の場合、html 出力メソッドは、 HTML ユーザエージェントによるレンダリングに影響を与えない範囲で, 結果ツリーの出力に空白を追加／削除してよい。 If the indent attribute has the value yes, then the html output method may add or remove whitespace as it outputs the result tree, so long as it does not change how an HTML user agent would render the output. The default value is yes.

html 出力メソッドは、 HTML 4.0 勧告 B.2.1 節 で推奨される方法を用いて, URI 属性の値に含まれる非 ASCII 文字をエスケープすべきである。 The html output method should escape non-ASCII characters in URI attribute values using the method recommended in Section B.2.1 of the HTML 4.0 Recommendation.

html 出力メソッドは、文字に対する文字実体参照が利用中の HTML のバージョンで定義されていれば, 文字実体参照を用いてその文字を出力してもよい。 The html output method may output a character using a character entity reference, if one is defined for it in the version of HTML that the output method is using.

html 出力メソッドは、 ?> ではなく > により処理命令を閉じるべきである。 The html output method should terminate processing instructions with > rather than ?>.

html 出力メソッドは、ブール型の属性（属性名と同じ値のみが, 値として許されている属性）を最小形で出力すべきである。 例えば, スタイルシートの次の開始タグ： The html output method should output boolean attributes (that is attributes with only a single allowed value that is equal to the name of the attribute) in minimized form. For example, a start-tag written in the stylesheet as

<OPTION selected="selected">

の出力は次のようになる： should be output as

<OPTION selected>

html 出力メソッドは属性値に現れる文字 { の直前の文字 & をエスケープすべきではない（ HTML 4.0 勧告の B.7.1 節 を見よ）。 例えば, スタイルシートに次の開始タグが記述されている場合： The html output method should not escape a & character occurring in an attribute value immediately followed by a { character (see Section B.7.1 of the HTML 4.0 Recommendation). For example, a start-tag written in the stylesheet as

<BODY bgcolor='&amp;{{randomrbg}};'>

出力は次のようになるべきである： should be output as

<BODY bgcolor='&{randomrbg};'>

encoding 属性は、 HTML 出力メソッドに利用する望ましい文字エンコーディングを指定する。 HEAD 要素がある場合、 html 出力メソッドは HEAD 要素の開始タグの直後に META 要素を追加して, 実際に用いられる文字エンコーディングを指定すべきである。 例えば： The encoding attribute specifies the preferred encoding to be used. If there is a HEAD element, then the html output method should add a META element immediately after the start-tag of the HEAD element specifying the character encoding actually used. For example,

<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=EUC-JP">
...

結果ツリーには、 XSLT プロセッサが出力に利用するエンコーディングで表現できない文字も含まれ得る。 この場合、 HTML において文字参照が認識され得る場所にその文字が現れるのであれば, 文字実体参照または十進コードによる文字参照として出力すべきである。 それ以外の場合（例えば script 要素や style 要素内, またはコメント内にその文字が現れた場合）、 XSLT プロセッサはエラーを通知すべきである。 It is possible that the result tree will contain a character that cannot be represented in the encoding that the XSLT processor is using for output. In this case, if the character occurs in a context where HTML recognizes character references, then the character should be output as a character entity reference or decimal numeric character reference; otherwise (for example, in a script or style element or in a comment), the XSLT processor should signal an error.

doctype-public 属性または doctype-system 属性が指定されている場合、 html 出力メソッドは最初の要素の直前に文書型宣言を出力すべきである。 <!DOCTYPE に後続する名前は、 HTML または html である。 doctype-public 属性も指定されている場合、出力メソッドは PUBLIC に続けて指定された公開識別子を出力すべきである。 doctype-system 属性も指定されている場合、公開識別子に続けてシステム識別子も出力すべきである。 doctype-system 属性は指定されているが, doctype-public 属性は指定されていない場合、出力メソッドは SYSTEM に続けて指定されたシステム識別子を出力すべきである。 If the doctype-public or doctype-system attributes are specified, then the html output method should output a document type declaration immediately before the first element. The name following <!DOCTYPE should be HTML or html. If the doctype-public attribute is specified, then the output method should output PUBLIC followed by the specified public identifier; if the doctype-system attribute is also specified, it should also output the specified system identifier following the public identifier. If the doctype-system attribute is specified but the doctype-public attribute is not specified, then the output method should output SYSTEM followed by the specified system identifier.

media-type 属性は html 出力メソッドに適用できる。 既定の値は text/html 。 The media-type attribute is applicable for the html output method. The default value is text/html.

16.3 テキスト出力メソッド

テキスト出力メソッドにおける結果ツリーの出力では、エスケープ処理を施さずに, 結果ツリーの各テキストノードの文字列値を文書順に出力する。 The text output method outputs the result tree by outputting the string-value of every text node in the result tree in document order without any escaping.

media-type 属性はテキスト出力メソッドに適用できる。 既定の値は text/plain である。 The media-type attribute is applicable for the text output method. The default value for the media-type attribute is text/plain.

encoding 属性には、テキスト出力メソッドが文字列をバイト列に変換する際に利用するエンコーディングを指定する。 既定の値はシステム依存になる。 XSLT プロセッサが出力に利用するエンコーディングでは表現できない文字が結果ツリーに含まれている場合、 XSLT プロセッサはエラーを通知すべきである。 The encoding attribute identifies the encoding that the text output method should use to convert sequences of characters to sequences of bytes. The default is system-dependent. If the result tree contains a character that cannot be represented in the encoding that the XSLT processor is using for output, the XSLT processor should signal an error.

16.4 出力エスケープの無効化

通常, xml 出力メソッドによるテキストノードの出力においては、 & や < （あるいは他の文字も）にエスケープが施される。 このような処理により、出力結果は確実に整形式 XML になる。 しかしながら、出力結果が完全ではなくともほぼ整形式 XML になっていることが便利な場合もある。 例えば、後段の XML 非対応の処理プロセスで整形式 XML に変換することを意図して, 整形式でないセクションを出力結果に含める場合など。 このため XSLT では、出力エスケープを無効化する仕組みを提供している。 xsl:value-of 要素や xsl:text 要素には、 disable-output-escaping 属性を与えられる。 値は yes または no （既定値）のいずれかであり, yes だった場合、 xsl:value-of 要素や xsl:text 要素のインスタンス化により生成されるテキストノードは, エスケープ処理を施さずに出力すべきである。 例えば： Normally, the xml output method escapes & and < (and possibly other characters) when outputting text nodes. This ensures that the output is well-formed XML. However, it is sometimes convenient to be able to produce output that is almost, but not quite well-formed XML; for example, the output may include ill-formed sections which are intended to be transformed into well-formed XML by a subsequent non-XML aware process. For this reason, XSLT provides a mechanism for disabling output escaping. An xsl:value-of or xsl:text element may have a disable-output-escaping attribute; the allowed values are yes or no; the default is no; if the value is yes, then a text node generated by instantiating the xsl:value-of or xsl:text element should be output without any escaping. For example,

<xsl:text disable-output-escaping="yes">&lt;</xsl:text>

は、１個の文字 < を生成する。 ルートノードが xsl:copy-of 要素を用いて複製される際に（ [11.3 xsl:copy-of における変数とパラメタの値の利用] を見よ）, ルートノードの子孫のテキストノードに対するエスケープが無効化されている場合、それらのテキストノードの複製結果に対するエスケープも無効化されるべきである。 例えば： should generate the single character <. When a root node is copied using an xsl:copy-of element (see [11.3 Using Values of Variables and Parameters with xsl:copy-of]) and escaping was disabled for a text node descendant of that root node, then escaping should also be disabled for the resulting copy of that text node. For example

<xsl:variable name="x">
  <xsl:text disable-output-escaping="yes">&lt;</xsl:text>
</xsl:variable>
<xsl:copy-of select="$x"/>

は < でなく, < と出力されるべきである。 . should output < not &lt;.

結果ツリーのテキストノード以外の部分に利用されるテキストノードに対する出力エスケープの無効化は、エラーとする。 従って、コメント, 処理命令, 属性ノードの文字列値の生成に利用される xsl:value-of 要素や xsl:text 要素に対する出力エスケープの無効化もエラーとする。 また、エスケープ処理を無効化したテキストノードが含まれている 結果ツリー素片 を数値や文字列に変換しようとした場合もエラーとする。 いずれの場合も、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、 disable-output-escaping 属性を無視してエラーから回復しなければならない。 It is an error for output escaping to be disabled for a text node that is used for something other than a text node in the result tree. Thus, it is an error to disable output escaping for an xsl:value-of or xsl:text element that is used to generate the string-value of a comment, processing instruction or attribute node; it is also an error to convert a result tree fragment to a number or a string if the result tree fragment contains a text node for which escaping was disabled. In both cases, an XSLT processor may signal the error; if it does not signal the error, it must recover by ignoring the disable-output-escaping attribute.

disable-output-escaping 属性は、 xml 出力メソッドのみならず, html 出力メソッドでも利用できる。 テキスト出力メソッドでは、出力のエスケープ処理は行われないので disable-output-escaping 属性は無視される。 The disable-output-escaping attribute may be used with the html output method as well as with the xml output method. The text output method ignores the disable-output-escaping attribute, since it does not perform any output escaping.

XSLT プロセッサは、結果ツリーの出力を制御する場合にのみ, 出力エスケープを無効にできるが、例外もある。 例えば、結果ツリーは出力以外にも別の XSLT 変換のソースツリーとして利用し得る。 XSLT プロセッサには、出力エスケープの無効化のサポートは要求されていない。 xsl:value-of や xsl:text に出力エスケープを無効化すべきことが指定されていて, XSLT プロセッサがそれをサポートしていない場合、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、出力エスケープの無効化を行わないことにより, エラーから回復しなければならない。 An XSLT processor will only be able to disable output escaping if it controls how the result tree is output. This may not always be the case. For example, the result tree may be used as the source tree for another XSLT transformation instead of being output. An XSLT processor is not required to support disabling output escaping. If an xsl:value-of or xsl:text specifies that output escaping should be disabled and the XSLT processor does not support this, the XSLT processor may signal an error; if it does not signal an error, it must recover by not disabling output escaping.

XSLT プロセッサが出力に利用するエンコーディングで表現できない文字に対し, 出力エスケープが無効化されている場合、 XSLT プロセッサはエラーを通知してもよい。 エラーを通知しない場合、出力エスケープの無効化を行わないことにより, エラーから回復しなければならない。 If output escaping is disabled for a character that is not representable in the encoding that the XSLT processor is using for output, then the XSLT processor may signal an error; if it does not signal an error, it must recover by not disabling output escaping.

出力エスケープの無効化は、すべての XSLT プロセッサで働くとは限らない上に, XML の出力結果は整形式にならない可能性もあるので、この機能は他に選択肢が無い場合に限って利用すべきである。 Since disabling output escaping may not work with all XSLT processors and can result in XML that is not well-formed, it should be used only when there is no alternative.

17 適合性

適合 XSLT プロセッサは、この仕様の規定に従って, スタイルシートを利用してソースツリーを結果ツリーに変換できなければならない。 適合 XSLT プロセッサには、 XML またはその他の形式による結果の出力機能は要求されていない。 A conforming XSLT processor must be able to use a stylesheet to transform a source tree into a result tree as specified in this document. A conforming XSLT processor need not be able to output the result in XML or in any other form.

注記： XSLT プロセッサのベンダには、結果ツリーを XML として出力可能にしたり, DOM や SAX などの標準 API からの結果ツリーへのアクセスを提供することにより、プロセッサのふるまいの適合性を検証する手段を提供することが強く奨励される。 NOTE:Vendors of XSLT processors are strongly encouraged to provide a way to verify that their processor is behaving conformingly by allowing the result tree to be output as XML or by providing access to the result tree through a standard API such as the DOM or SAX.

適合 XSLT プロセッサは、この仕様でエラーを通知しなくてよいことを特に指定しているもの以外の, すべてのエラーを通知しなければならない。 適合 XSLT プロセッサは、通知したエラーから回復してもよいが, エラーからの回復は適合性の要件ではない。 A conforming XSLT processor must signal any errors except for those that this document specifically allows an XSLT processor not to signal. A conforming XSLT processor may but need not recover from any errors that it signals.

適合 XSLT プロセッサは、スタイルシートの処理に消費される処理演算リソースに制限を設けてもよい。 A conforming XSLT processor may impose limits on the processing resources consumed by the processing of a stylesheet.

18 表記法

XSLT で定義する要素型それぞれの仕様記述の最初に、その要素型の要素を見本にした構文の要約を与えている。 構文の要約における表記法の意味は、次のようになる： The specification of each XSLT-defined element type is preceded by a summary of its syntax in the form of a model for elements of that element type. The meaning of syntax summary notation is as follows:

• 必ず指定しなければならない属性は太字で表記。 An attribute is required if and only if its name is in bold.

• 属性値のあたる部分の文字列は、その属性で利用できる値を指定する。 この文字列が波括弧で括られている場合、属性値は 属性値テンプレート として扱われ, 波括弧内部の文字列は、属性値テンプレートのインスタンス化の結果として許容される値を指定する。 値として複数の選択肢が許容される所は | で区切られる。 引用符で括られた文字列は、その文字列そのものが値になることを示す。 引用符で囲まれていない斜体の名前は、特定の型の値を指す。 The string that occurs in the place of an attribute value specifies the allowed values of the attribute. If this is surrounded by curly braces, then the attribute value is treated as an attribute value template, and the string occurring within curly braces specifies the allowed values of the result of instantiating the attribute value template. Alternative allowed values are separated by |. A quoted string indicates a value equal to that specific string. An unquoted, italicized name specifies a particular type of value.

• 空要素でなくてもよい要素の場合、許容される内容を指定するコメントが要素内に記述される。 許容される内容は、 XML の要素型宣言と同様の形式で指定される。 template は、テキストノード, リテラル結果要素, 拡張要素, instruction に分類される XSLT 要素を任意に組み合わせて利用できることを意味する。 top-level-elements は、 top-level-element に分類される XSLT 要素を任意に組み合わせて利用できることを意味する。 If the element is allowed not to be empty, then the element contains a comment specifying the allowed content. The allowed content is specified in a similar way to an element type declaration in XML; template means that any mixture of text nodes, literal result elements, extension elements, and XSLT elements from the instruction category is allowed; top-level-elements means that any mixture of XSLT elements from the top-level-element category is allowed.

• 要素の最初に、その要素がどの分類に属するかが示される： instruction か, top-level-element か, またはその両方か。 この分類は、単にその要素が template または top-level-elements を内容に許容する要素の内容として許容されるかどうかを表すためのものである。 The element is prefaced by comments indicating if it belongs to the instruction category or top-level-element category or both. The category of an element just affects whether it is allowed in the content of elements that allow a template or top-level-elements.

A 参照文献

A.1 正式な参照文献

A.2 その他の参照文献

B 要素構文要約

<!-- Category: instruction -->
<xsl:apply-imports />

<!-- Category: instruction -->
<xsl:apply-templates 
  select = node-set-expression 
  mode = qname>
  <!-- Content: (xsl:sort | xsl:with-param)* -->
</xsl:apply-templates>

<!-- Category: instruction -->
<xsl:attribute
  name = { qname }
  namespace = { uri-reference }>
  <!-- Content: template -->
</xsl:attribute>

<!-- Category: top-level-element -->
<xsl:attribute-set
  name = qname 
  use-attribute-sets = qnames>
  <!-- Content: xsl:attribute* -->
</xsl:attribute-set>

<!-- Category: instruction -->
<xsl:call-template
  name = qname>
  <!-- Content: xsl:with-param* -->
</xsl:call-template>

<!-- Category: instruction -->
<xsl:choose>
  <!-- Content: (xsl:when+, xsl:otherwise?) -->
</xsl:choose>

<!-- Category: instruction -->
<xsl:comment>
  <!-- Content: template -->
</xsl:comment>

<!-- Category: instruction -->
<xsl:copy 
  use-attribute-sets = qnames>
  <!-- Content: template -->
</xsl:copy>

<!-- Category: instruction -->
<xsl:copy-of
  select = expression />

<!-- Category: top-level-element -->
<xsl:decimal-format 
  name = qname 
  decimal-separator = char 
  grouping-separator = char 
  infinity = string 
  minus-sign = char 
  NaN = string 
  percent = char 
  per-mille = char 
  zero-digit = char 
  digit = char 
  pattern-separator = char />

<!-- Category: instruction -->
<xsl:element
  name = { qname }
  namespace = { uri-reference }
  use-attribute-sets = qnames>
  <!-- Content: template -->
</xsl:element>

<!-- Category: instruction -->
<xsl:fallback>
  <!-- Content: template -->
</xsl:fallback>

<!-- Category: instruction -->
<xsl:for-each
         select = node-set-expression>
  <!-- Content: (xsl:sort*, template) -->
</xsl:for-each>

<!-- Category: instruction -->
<xsl:if
         test = boolean-expression>
  <!-- Content: template -->
</xsl:if>

<xsl:import
         href = uri-reference />

<!-- Category: top-level-element -->
<xsl:include
         href = uri-reference />

<!-- Category: top-level-element -->
<xsl:key
  name = qname
         match = pattern
         use = expression />

<!-- Category: instruction -->
<xsl:message 
  terminate = "yes" | "no">
  <!-- Content: template -->
</xsl:message>

<!-- Category: top-level-element -->
<xsl:namespace-alias
         stylesheet-prefix = prefix | "#default"
  result-prefix = prefix | "#default" />

<!-- Category: instruction -->
<xsl:number 
  level = "single" | "multiple" | "any"
  count = pattern 
  from = pattern 
  value = number-expression 
  format = { string }
  lang = { nmtoken }
  letter-value = { "alphabetic" | "traditional" }
  grouping-separator = { char }
  grouping-size = { number } />

<xsl:otherwise>
  <!-- Content: template -->
</xsl:otherwise>

<!-- Category: top-level-element -->
<xsl:output 
  method = "xml" | "html" | "text" | qname-but-not-ncname 
  version = nmtoken 
  encoding = string 
  omit-xml-declaration = "yes" | "no"
  standalone = "yes" | "no"
  doctype-public = string 
  doctype-system = string 
  cdata-section-elements = qnames 
  indent = "yes" | "no"
  media-type = string />

<!-- Category: top-level-element -->
<xsl:param
  name = qname 
  select = expression>
  <!-- Content: template -->
</xsl:param>

<!-- Category: top-level-element -->
<xsl:preserve-space
         elements = tokens />

<!-- Category: instruction -->
<xsl:processing-instruction
  name = { ncname }>
  <!-- Content: template -->
</xsl:processing-instruction>

<xsl:sort 
  select = string-expression 
  lang = { nmtoken }
  data-type = { "text" | "number" | qname-but-not-ncname }
  order = { "ascending" | "descending" }
  case-order = { "upper-first" | "lower-first" } />

<!-- Category: top-level-element -->
<xsl:strip-space
         elements = tokens />

<xsl:stylesheet 
  id = id 
  extension-element-prefixes = tokens 
  exclude-result-prefixes = tokens
         version = number>
  <!-- Content: (xsl:import*, top-level-elements) -->
</xsl:stylesheet>

<!-- Category: top-level-element -->
<xsl:template 
  match = pattern 
  name = qname 
  priority = number 
  mode = qname>
  <!-- Content: (xsl:param*, template) -->
</xsl:template>

<!-- Category: instruction -->
<xsl:text 
  disable-output-escaping = "yes" | "no">
  <!-- Content: #PCDATA -->
</xsl:text>

<xsl:transform 
  id = id 
  extension-element-prefixes = tokens 
  exclude-result-prefixes = tokens
         version = number>
  <!-- Content: (xsl:import*, top-level-elements) -->
</xsl:transform>

<!-- Category: instruction -->
<xsl:value-of
         select = string-expression 
  disable-output-escaping = "yes" | "no" />

<!-- Category: top-level-element -->
<!-- Category: instruction -->
<xsl:variable
  name = qname 
  select = expression>
  <!-- Content: template -->
</xsl:variable>

<xsl:when
         test = boolean-expression>
  <!-- Content: template -->
</xsl:when>

<xsl:with-param
  name = qname 
  select = expression>
  <!-- Content: template -->
</xsl:with-param>

C XSLT スタイルシート用 DTD 素片（規定外）

注記： この DTD 素片は、正式ではない。 理由は、 XML 1.0 の DTD は XML 名前空間をサポートしていないため, XSLT スタイルシートが許容する構造を正しく記述できないためである。 NOTE:This DTD Fragment is not normative because XML 1.0 DTDs do not support XML Namespaces and thus cannot correctly describe the allowed structure of an XSLT stylesheet.

下の実体を、特定の結果 DTD のインスタンスを生成する XSLT スタイルシート用の DTD の構築に利用できる。 この実体が参照される前に、スタイルシート用の DTD に結果において許容される要素を列挙する result-elements パラメタ実体が定義されなければならない。 例えば： The following entity can be used to construct a DTD for XSLT stylesheets that create instances of a particular result DTD. Before referencing the entity, the stylesheet DTD must define a result-elements parameter entity listing the allowed result element types. For example:

<!ENTITY % result-elements "
  | fo:inline-sequence
  | fo:block
">

このような結果要素は、属性として xsl:use-attribute-sets と xsl:extension-element-prefixes を持つことを宣言しておくべきである。 下の実体で、この目的に result-element-atts パラメタを宣言する。 XSLT が結果要素に許容する内容は、次の実体の中で内容モデル %template; を伴って宣言される XSLT の要素に対し許容される内容と同じである。 DTD では、結果 DTD にかけられる制約を反映させるため, %template; より制限が強い内容モデルを利用してもよい。 Such result elements should be declared to have xsl:use-attribute-sets and xsl:extension-element-prefixes attributes. The following entity declares the result-element-atts parameter for this purpose. The content that XSLT allows for result elements is the same as it allows for the XSLT elements that are declared in the following entity with a content model of %template;. The DTD may use a more restrictive content model than %template; to reflect the constraints of the result DTD.

この DTD では、 XSLT 名前空間以外の名前空間から追加のトップレベル要素を許容するために non-xsl-top-level パラメタ実体を定義してもよい。 The DTD may define the non-xsl-top-level parameter entity to allow additional top-level elements from namespaces other than the XSLT namespace.

この DTD は接頭辞 xsl: を利用しているが、 XSLT のスタイルシートでもこの接頭辞の利用が要求されるわけではない。 この DTD で宣言しているすべての要素は、この DTD で宣言される属性に加え, xmlns: から始まる名前の属性や名前が xmlns の属性を持ち得る。 The use of the xsl: prefix in this DTD does not imply that XSLT stylesheets are required to use this prefix. Any of the elements declared in this DTD may have attributes whose name starts with xmlns: or is equal to xmlns in addition to the attributes declared in this DTD.

<!ENTITY % char-instructions "
  | xsl:apply-templates
  | xsl:call-template
  | xsl:apply-imports
  | xsl:for-each
  | xsl:value-of
  | xsl:copy-of
  | xsl:number
  | xsl:choose
  | xsl:if
  | xsl:text
  | xsl:copy
  | xsl:variable
  | xsl:message
  | xsl:fallback
">

<!ENTITY % instructions "
  %char-instructions;
  | xsl:processing-instruction
  | xsl:comment
  | xsl:element
  | xsl:attribute
">

<!ENTITY % char-template "
 (#PCDATA
  %char-instructions;)*
">

<!ENTITY % template "
 (#PCDATA
  %instructions;
  %result-elements;)*
">

<!-- Used for the type of an attribute value that is a URI reference.-->
<!ENTITY % URI "CDATA">

<!-- Used for the type of an attribute value that is a pattern.-->
<!ENTITY % pattern "CDATA">

<!-- Used for the type of an attribute value that is an
     attribute value template.-->
<!ENTITY % avt "CDATA">

<!-- Used for the type of an attribute value that is a QName; the prefix
     gets expanded by the XSLT processor. -->
<!ENTITY % qname "NMTOKEN">

<!-- Like qname but a whitespace-separated list of QNames. -->
<!ENTITY % qnames "NMTOKENS">

<!-- Used for the type of an attribute value that is an expression.-->
<!ENTITY % expr "CDATA">

<!-- Used for the type of an attribute value that consists
     of a single character.-->
<!ENTITY % char "CDATA">

<!-- Used for the type of an attribute value that is a priority. -->
<!ENTITY % priority "NMTOKEN">

<!ENTITY % space-att "xml:space (default|preserve) #IMPLIED">

<!-- This may be overridden to customize the set of elements allowed
at the top-level. -->

<!ENTITY % non-xsl-top-level "">

<!ENTITY % top-level "
 (xsl:import*,
  (xsl:include
  | xsl:strip-space
  | xsl:preserve-space
  | xsl:output
  | xsl:key
  | xsl:decimal-format
  | xsl:attribute-set
  | xsl:variable
  | xsl:param
  | xsl:template
  | xsl:namespace-alias
  %non-xsl-top-level;)*)
">

<!ENTITY % top-level-atts '
  extension-element-prefixes CDATA #IMPLIED
  exclude-result-prefixes CDATA #IMPLIED
  id ID #IMPLIED
  version NMTOKEN #REQUIRED
  xmlns:xsl CDATA #FIXED "http://www.w3.org/1999/XSL/Transform"
  %space-att;
'>

<!-- This entity is defined for use in the ATTLIST declaration
for result elements. -->

<!ENTITY % result-element-atts '
  xsl:extension-element-prefixes CDATA #IMPLIED
  xsl:exclude-result-prefixes CDATA #IMPLIED
  xsl:use-attribute-sets %qnames; #IMPLIED
  xsl:version NMTOKEN #IMPLIED
'>

<!ELEMENT xsl:stylesheet %top-level;>
<!ATTLIST xsl:stylesheet %top-level-atts;>

<!ELEMENT xsl:transform %top-level;>
<!ATTLIST xsl:transform %top-level-atts;>

<!ELEMENT xsl:import EMPTY>
<!ATTLIST xsl:import href %URI; #REQUIRED>

<!ELEMENT xsl:include EMPTY>
<!ATTLIST xsl:include href %URI; #REQUIRED>

<!ELEMENT xsl:strip-space EMPTY>
<!ATTLIST xsl:strip-space elements CDATA #REQUIRED>

<!ELEMENT xsl:preserve-space EMPTY>
<!ATTLIST xsl:preserve-space elements CDATA #REQUIRED>

<!ELEMENT xsl:output EMPTY>
<!ATTLIST xsl:output
  method %qname; #IMPLIED
  version NMTOKEN #IMPLIED
  encoding CDATA #IMPLIED
  omit-xml-declaration (yes|no) #IMPLIED
  standalone (yes|no) #IMPLIED
  doctype-public CDATA #IMPLIED
  doctype-system CDATA #IMPLIED
  cdata-section-elements %qnames; #IMPLIED
  indent (yes|no) #IMPLIED
  media-type CDATA #IMPLIED
>

<!ELEMENT xsl:key EMPTY>
<!ATTLIST xsl:key
  name %qname; #REQUIRED
  match %pattern; #REQUIRED
  use %expr; #REQUIRED
>

<!ELEMENT xsl:decimal-format EMPTY>
<!ATTLIST xsl:decimal-format
  name %qname; #IMPLIED
  decimal-separator %char; "."
  grouping-separator %char; ","
  infinity CDATA "Infinity"
  minus-sign %char; "-"
  NaN CDATA "NaN"
  percent %char; "%"
  per-mille %char; "&#x2030;"
  zero-digit %char; "0"
  digit %char; "#"
  pattern-separator %char; ";"
>

<!ELEMENT xsl:namespace-alias EMPTY>
<!ATTLIST xsl:namespace-alias
  stylesheet-prefix CDATA #REQUIRED
  result-prefix CDATA #REQUIRED
>

<!ELEMENT xsl:template
 (#PCDATA
  %instructions;
  %result-elements;
  | xsl:param)*
>

<!ATTLIST xsl:template
  match %pattern; #IMPLIED
  name %qname; #IMPLIED
  priority %priority; #IMPLIED
  mode %qname; #IMPLIED
  %space-att;
>

<!ELEMENT xsl:value-of EMPTY>
<!ATTLIST xsl:value-of
  select %expr; #REQUIRED
  disable-output-escaping (yes|no) "no"
>

<!ELEMENT xsl:copy-of EMPTY>
<!ATTLIST xsl:copy-of select %expr; #REQUIRED>

<!ELEMENT xsl:number EMPTY>
<!ATTLIST xsl:number
   level (single|multiple|any) "single"
   count %pattern; #IMPLIED
   from %pattern; #IMPLIED
   value %expr; #IMPLIED
   format %avt; '1'
   lang %avt; #IMPLIED
   letter-value %avt; #IMPLIED
   grouping-separator %avt; #IMPLIED
   grouping-size %avt; #IMPLIED
>

<!ELEMENT xsl:apply-templates (xsl:sort|xsl:with-param)*>
<!ATTLIST xsl:apply-templates
  select %expr; "node()"
  mode %qname; #IMPLIED
>

<!ELEMENT xsl:apply-imports EMPTY>

<!-- xsl:sort cannot occur after any other elements or
any non-whitespace character -->

<!ELEMENT xsl:for-each
 (#PCDATA
  %instructions;
  %result-elements;
  | xsl:sort)*
>

<!ATTLIST xsl:for-each
  select %expr; #REQUIRED
  %space-att;
>

<!ELEMENT xsl:sort EMPTY>
<!ATTLIST xsl:sort
  select %expr; "."
  lang %avt; #IMPLIED
  data-type %avt; "text"
  order %avt; "ascending"
  case-order %avt; #IMPLIED
>

<!ELEMENT xsl:if %template;>
<!ATTLIST xsl:if
  test %expr; #REQUIRED
  %space-att;
>

<!ELEMENT xsl:choose (xsl:when+, xsl:otherwise?)>
<!ATTLIST xsl:choose %space-att;>

<!ELEMENT xsl:when %template;>
<!ATTLIST xsl:when
  test %expr; #REQUIRED
  %space-att;
>

<!ELEMENT xsl:otherwise %template;>
<!ATTLIST xsl:otherwise %space-att;>

<!ELEMENT xsl:attribute-set (xsl:attribute)*>
<!ATTLIST xsl:attribute-set
  name %qname; #REQUIRED
  use-attribute-sets %qnames; #IMPLIED
>

<!ELEMENT xsl:call-template (xsl:with-param)*>
<!ATTLIST xsl:call-template
  name %qname; #REQUIRED
>

<!ELEMENT xsl:with-param %template;>
<!ATTLIST xsl:with-param
  name %qname; #REQUIRED
  select %expr; #IMPLIED
>

<!ELEMENT xsl:variable %template;>
<!ATTLIST xsl:variable 
  name %qname; #REQUIRED
  select %expr; #IMPLIED
>

<!ELEMENT xsl:param %template;>
<!ATTLIST xsl:param 
  name %qname; #REQUIRED
  select %expr; #IMPLIED
>

<!ELEMENT xsl:text (#PCDATA)>
<!ATTLIST xsl:text
  disable-output-escaping (yes|no) "no"
>

<!ELEMENT xsl:processing-instruction %char-template;>
<!ATTLIST xsl:processing-instruction 
  name %avt; #REQUIRED
  %space-att;
>

<!ELEMENT xsl:element %template;>
<!ATTLIST xsl:element 
  name %avt; #REQUIRED
  namespace %avt; #IMPLIED
  use-attribute-sets %qnames; #IMPLIED
  %space-att;
>

<!ELEMENT xsl:attribute %char-template;>
<!ATTLIST xsl:attribute 
  name %avt; #REQUIRED
  namespace %avt; #IMPLIED
  %space-att;
>

<!ELEMENT xsl:comment %char-template;>
<!ATTLIST xsl:comment %space-att;>

<!ELEMENT xsl:copy %template;>
<!ATTLIST xsl:copy
  %space-att;
  use-attribute-sets %qnames; #IMPLIED
>

<!ELEMENT xsl:message %template;>
<!ATTLIST xsl:message
  %space-att;
  terminate (yes|no) "no"
>

<!ELEMENT xsl:fallback %template;>
<!ATTLIST xsl:fallback %space-att;>

D 例（規定外）

D.1 文書例

この例は単純な DTD に適合する文書を XHTML [XHTML] へ変換するスタイルシートである。 DTD は： This example is a stylesheet for transforming documents that conform to a simple DTD into XHTML [XHTML]. The DTD is:

<!ELEMENT doc (title, chapter*)>
<!ELEMENT chapter (title, (para|note)*, section*)>
<!ELEMENT section (title, (para|note)*)>
<!ELEMENT title (#PCDATA|emph)*>
<!ELEMENT para (#PCDATA|emph)*>
<!ELEMENT note (#PCDATA|emph)*>
<!ELEMENT emph (#PCDATA|emph)*>

スタイルシートは： The stylesheet is:

<xsl:stylesheet version="1.0"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns="http://www.w3.org/TR/xhtml1/strict">

<xsl:strip-space elements="doc chapter section"/>
<xsl:output
   method="xml"
   indent="yes"
   encoding="iso-8859-1"
/>

<xsl:template match="doc">
 <html>
   <head>
     <title>
       <xsl:value-of select="title"/>
     </title>
   </head>
   <body>
     <xsl:apply-templates/>
   </body>
 </html>
</xsl:template>

<xsl:template match="doc/title">
  <h1>
    <xsl:apply-templates/>
  </h1>
</xsl:template>

<xsl:template match="chapter/title">
  <h2>
    <xsl:apply-templates/>
  </h2>
</xsl:template>

<xsl:template match="section/title">
  <h3>
    <xsl:apply-templates/>
  </h3>
</xsl:template>

<xsl:template match="para">
  <p>
    <xsl:apply-templates/>
  </p>
</xsl:template>

<xsl:template match="note">
  <p class="note">
    <b>NOTE: </b>
    <xsl:apply-templates/>
  </p>
</xsl:template>

<xsl:template match="emph">
  <em>
    <xsl:apply-templates/>
  </em>
</xsl:template>

</xsl:stylesheet>

次の入力の文書： With the following input document

<!DOCTYPE doc SYSTEM "doc.dtd">
<doc>
<title>Document Title</title>
<chapter>
<title>Chapter Title</title>
<section>
<title>Section Title</title>
<para>This is a test.</para>
<note>This is a note.</note>
</section>
<section>
<title>Another Section Title</title>
<para>This is <emph>another</emph> test.</para>
<note>This is another note.</note>
</section>
</chapter>
</doc>

から、次の結果が生成される： it would produce the following result

<?xml version="1.0" encoding="iso-8859-1"?>
<html xmlns="http://www.w3.org/TR/xhtml1/strict">
<head>
<title>Document Title</title>
</head>
<body>
<h1>Document Title</h1>
<h2>Chapter Title</h2>
<h3>Section Title</h3>
<p>This is a test.</p>
<p class="note">
<b>NOTE: </b>This is a note.</p>
<h3>Another Section Title</h3>
<p>This is <em>another</em> test.</p>
<p class="note">
<b>NOTE: </b>This is another note.</p>
</body>
</html>

D.2 データ例

この節では XML で表現されているデータを異なる３つの XSLT スタイルシートを用いて変換し、異なる３つのデータ表現 HTML, SVG, VRML を生成する例を示す。 This is an example of transforming some data represented in XML using three different XSLT stylesheets to produce three different representations of the data, HTML, SVG and VRML.

入力データは： The input data is:

<sales>

        <division id="North">
                <revenue>10</revenue>
                <growth>9</growth>
                <bonus>7</bonus>
        </division>

        <division id="South">
                <revenue>4</revenue>
                <growth>3</growth>
                <bonus>4</bonus>
        </division>

        <division id="West">
                <revenue>6</revenue>
                <growth>-1.5</growth>
                <bonus>2</bonus>
        </division>

</sales>

次のスタイルシートは [2.3 スタイルシートとしてのリテラル結果要素] で述べられた簡略構文を用いてデータを HTML に変換する： The following stylesheet, which uses the simplified syntax described in [2.3 Literal Result Element as Stylesheet], transforms the data into HTML:

<html xsl:version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
      lang="en">
    <head>
        <title>Sales Results By Division</title>
    </head>
    <body>
        <table border="1">
            <tr>
                <th>Division</th>
                <th>Revenue</th>
                <th>Growth</th>
                <th>Bonus</th>
            </tr>
            <xsl:for-each select="sales/division">
                <!-- order the result by revenue -->
                <xsl:sort select="revenue"
                          data-type="number"
                          order="descending"/>
                <tr>
                    <td>
                        <em><xsl:value-of select="@id"/></em>
                    </td>
                    <td>
                        <xsl:value-of select="revenue"/>
                    </td>
                    <td>
                        <!-- highlight negative growth in red -->
                        <xsl:if test="growth &lt; 0">
                             <xsl:attribute name="style">
                                 <xsl:text>color:red</xsl:text>
                             </xsl:attribute>
                        </xsl:if>
                        <xsl:value-of select="growth"/>
                    </td>
                    <td>
                        <xsl:value-of select="bonus"/>
                    </td>
                </tr>
            </xsl:for-each>
        </table>
    </body>
</html>

出力される HTML は： The HTML output is:

<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>Sales Results By Division</title>
</head>
<body>
<table border="1">
<tr>
<th>Division</th><th>Revenue</th><th>Growth</th><th>Bonus</th>
</tr>
<tr>
<td><em>North</em></td><td>10</td><td>9</td><td>7</td>
</tr>
<tr>
<td><em>West</em></td><td>6</td><td style="color:red">-1.5</td><td>2</td>
</tr>
<tr>
<td><em>South</em></td><td>4</td><td>3</td><td>4</td>
</tr>
</table>
</body>
</html>

次のスタイルシートはデータを SVG に変換する： The following stylesheet transforms the data into SVG:

<xsl:stylesheet version="1.0"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns="http://www.w3.org/Graphics/SVG/SVG-19990812.dtd">

<xsl:output method="xml" indent="yes" media-type="image/svg"/>

<xsl:template match="/">

<svg width = "3in" height="3in">
    <g style = "stroke: #000000"> 
        <!-- draw the axes -->
        <line x1="0" x2="150" y1="150" y2="150"/>
        <line x1="0" x2="0" y1="0" y2="150"/>
        <text x="0" y="10">Revenue</text>
        <text x="150" y="165">Division</text>
        <xsl:for-each select="sales/division">
            <!-- define some useful variables -->

            <!-- the bar's x position -->
            <xsl:variable name="pos"
                          select="(position()*40)-30"/>

            <!-- the bar's height -->
            <xsl:variable name="height"
                          select="revenue*10"/>

            <!-- the rectangle -->
            <rect x="{$pos}" y="{150-$height}"
                  width="20" height="{$height}"/>

            <!-- the text label -->
            <text x="{$pos}" y="165">
                <xsl:value-of select="@id"/>
            </text> 

            <!-- the bar value -->
            <text x="{$pos}" y="{145-$height}">
                <xsl:value-of select="revenue"/>
            </text>
        </xsl:for-each>
    </g>
</svg>

</xsl:template>
</xsl:stylesheet>

出力される SVG は： The SVG output is:

<svg width="3in" height="3in"
     xmlns="http://www.w3.org/Graphics/SVG/svg-19990412.dtd">
    <g style="stroke: #000000">
        <line x1="0" x2="150" y1="150" y2="150"/>
        <line x1="0" x2="0" y1="0" y2="150"/>
        <text x="0" y="10">Revenue</text>
        <text x="150" y="165">Division</text>
        <rect x="10" y="50" width="20" height="100"/>
        <text x="10" y="165">North</text>
        <text x="10" y="45">10</text>
        <rect x="50" y="110" width="20" height="40"/>
        <text x="50" y="165">South</text>
        <text x="50" y="105">4</text>
        <rect x="90" y="90" width="20" height="60"/>
        <text x="90" y="165">West</text>
        <text x="90" y="85">6</text>
    </g>
</svg>

次のスタイルシートはデータを VRML に変換する： The following stylesheet transforms the data into VRML:

<xsl:stylesheet version="1.0"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<!-- generate text output as mime type model/vrml, using default charset -->
<xsl:output method="text" encoding="UTF-8" media-type="model/vrml"/>  

        <xsl:template match="/">#VRML V2.0 utf8 
 
# externproto definition of a single bar element 
EXTERNPROTO bar [ 
  field SFInt32 x  
  field SFInt32 y  
  field SFInt32 z  
  field SFString name  
  ] 
  "http://www.vrml.org/WorkingGroups/dbwork/barProto.wrl" 
 
# inline containing the graph axes 
Inline {  
        url "http://www.vrml.org/WorkingGroups/dbwork/barAxes.wrl" 
        } 
        
                <xsl:for-each select="sales/division">
bar {
        x <xsl:value-of select="revenue"/>
        y <xsl:value-of select="growth"/>
        z <xsl:value-of select="bonus"/>
        name "<xsl:value-of select="@id"/>" 
        }
                </xsl:for-each>
        
        </xsl:template> 
 
</xsl:stylesheet>

出力される VRML は： The VRML output is:

#VRML V2.0 utf8 
 
# externproto definition of a single bar element 
EXTERNPROTO bar [ 
  field SFInt32 x  
  field SFInt32 y  
  field SFInt32 z  
  field SFString name  
  ] 
  "http://www.vrml.org/WorkingGroups/dbwork/barProto.wrl" 
 
# inline containing the graph axes 
Inline {  
        url "http://www.vrml.org/WorkingGroups/dbwork/barAxes.wrl" 
        } 
        
                
bar {
        x 10
        y 9
        z 7
        name "North" 
        }
                
bar {
        x 4
        y 3
        z 4
        name "South" 
        }
                
bar {
        x 6
        y -1.5
        z 2
        name "West" 
        }

E 謝辞（規定外）

F 勧告案からの変更点（規定外）

G XSLT の将来版に検討中の機能（規定外）