XSLT <xsl:key> 要素

定義と使用方法

<xsl:key> 要素はトップレベルの要素であり、名前付きのキー(XML 文書内で指定された要素に割り当てられた名前と値のペア)を宣言できます。

このキーは key() 関数を通じてスタイルシート内で使用され、複雑な XML 文書内で割り当てられた要素に効果的にアクセスを助けます。

注記:キーはユニークでなくても構いません!

文法

<xsl:key
name="name"
match="pattern"
use="expression"/>

属性

属性 説明
name name 必須。キーの名前を指定します。
match pattern 必須。このキーが適用されるノードを定義します。
use expression

必須。このキーとして値を使用するための式を指定します。

キー値は以下のいずれかの値ができます:属性、子要素またはマッチング要素の内容。

例 1

「persons.xml」という名前の XML ファイルをお持ちであれば:

<persons>
  <person name="Tarzan" id="050676"/>
  <person name="Donald" id="070754"/>
  <person name="Dolly" id="231256"/>
</persons>

XSL ファイル内でキーを定義できます、例えば:

<xsl:key name="preg" match="person" use="@id"/>

id="050676" の person を見つけるために、これらのコードを使用してください(XSL ファイル内で):

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
<xsl:key name="preg" match="person" use="@id"/>
<xsl:template match="/">
  <html>
  <body>
  <xsl:for-each select="key('preg','050676')">
    <p>
    Id: <xsl:value-of select="@id"/><br />
    Name: <xsl:value-of select="@name"/>
    </p>
  </xsl:for-each>
  </body>
  </html>
</xsl:template>
</xsl:stylesheet>