<xsl: apply-templates> エレメントはテンプレート内から他のテンプレートを呼び出すときに使用されます。
このエレメントが評価されるときは「選択 (select)」属性を使用してどのコンテキスト・ノードが使用されるか判別し、そして
それらの「モード (mode)」値を使用して「モード (mode)」属性が特定のテンプレートを呼び出します。
次の説明は Resource パースペクティブを対象にしていますが、他のさまざまなパースペクティブでも使用できます。
XSL ファイルに <xsl:apply-templates> エレメントを追加するには、以下のステップに従ってください。
<xsl:apply-templates> エレメントは定義中であるため、読み取り専用フィールドに表示されます。
- XSL エディターで XSL ファイルを開く。
- 「断片 (Snippets)」タブをクリックし、XSL ドロワーを開き、それから xsl:apply-templates element
をダブルクリックします。
- スタイル・シートの一致テンプレートがリストされます。 特に一致テンプレートを起動したい場合は、
select 式の値として突き合わせパターンの値を使用することができます。
また、この突き合わせパターンを、select 式を詳細化する際のガイドとして使用することもできます。
- 「パラメーター・リスト (Parameter list)」の xsl:apply-templates をクリックする。
- Mode 属性はオプションです。 この属性は、同じ値を共用しているテンプレートを 1 つのグループにまとめることができるように、
モジュール性を設定するために使用されます。xsl:apply-templates が呼び出すただ1つテンプレートは、このフィールドにユーザーが
入力するものと同じ モード (mode) 値を持つテンプレートです。
- Select 属性はオプションです。 この属性を指定しないと、
現行ノードのすべての子が選択されます。指定すると、突き合わされるノードは、
「選択 (Select)」フィールドの XPath 式の値によって決まります。
「選択 (Select)」フィールドの値を作成するには、次のいずれかの方法を使用できます。
- このフィールドに XPath 式を入力する。
- 「XPath 式 (XPath Expression)」ウィザードを使用して XPath 式を作成する場合は、
「XPath」をクリックする。
- 「突き合わせパターンの選択 (Select a match pattern)」フィールドで突き合わせパターンを選択する。
- (オプション) 「パラメーターの追加 (Add Parameter)」ボタンをクリックして、xsl:with-param> パラメーターを追加する。 パラメーターは xsl:with-param エレメントを使用してテンプレートに渡されます。
既にパラメーターを定義済みの一致テンプレートを選択すると、
パラメーターは自動的にパラメーター・リストに追加されます。
- 作成したパラメーターを選択する。
- 「名前」フィールドにパラメーターの名前を入力する。
- 「選択 (Select)」フィールドにパラメーターのデフォルト値を入力する。 「XPath 式 (XPath Expression)」ウィザードを使用してデフォルト値を作成する場合は、 「XPath」をクリックする。
- 「完了」をクリックすると、<xsl:apply-templates> エレメントは XSL ファイルに挿入されます。