XSLT - Anwenden von Templates

Übersicht: XSLT - Anwenden von Templates

• xsl:apply-templates
• Built-in Template Rules
• xsl:call-template
• Übergabe von Parametern

---

xsl:apply-templates

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

Mittels xsl:apply-templates können Templates angewendet werden. Dabei wird im select-Attribut ein XPath-Ausdruck angegeben, der - ausgehend vom Current Node - die zu bearbeitenden Knoten auswählt. Das Ergebnis ist ein Node Set, das vom XSLT-Prozessor zum weiteren Traversieren des Quelldokuments genutzt wird. Das Node Set wird dabei Element für Element abgearbeitet und jeweils eine entsprechende Template Rule gesucht. Dabei wird das aktuelle Element im Node Set zum Current Node des Prozesses.

Wenn keine Template Rule existiert, werden implizite Regeln angewendet.

Wird kein select-Argument angegeben, beinhaltet das Node Set alle Knoten auf der child-Achse, was folgenden Ausdrücken entspricht: select='child::*' oder select='*'.

Der Parameter mode dient zur weiteren Auswahl der anzuwendenden Template Rule. Beim Aufruf kann die Template Rule mittels des xsl:with-param-Konstrukts mit Parametern versorgt werden. Das Node Set, das durch das select-Attribut gebildet wird, kann mittels xsl:sort nach verschiedenen Kriterien sortiert werden.

---

Built-in Template Rules

Die eingebauten Template Rules entbinden den Anwender von der Definition des Verhaltens für Character Data oder Elemente, zu denen es kein Template gibt. Diese Regeln besagen, dass dann alle Kindelemente durchwandert werden und für jedes davon implizit wieder ein xsl:apply-templates aufgerufen wird. Trifft der XSLT-Prozessor dann auf Character Data und ist auch hier kein explizites Template definiert, wird implizit xsl:value-of aufgerufen und die Zeichendaten in das Ausgabedokument überführt.

Diese Built-in Template Rules sind für alle Elementtypen definiert:

• Template für Elemente und die Dokumentwurzel
  
  <xsl:template match="* | /">
    <xsl:apply-templates/>
  </xsl:template>
  
  Diese Regel besagt, dass alle Kindknoten des aktuellen Elements aufgerufen werden. Im Falle eines leeren Stylesheets führt dies zu einer Traversierung des Quelldokuments von der Wurzel bis zu den Blättern. Durch die Built-in Template Rule für Textknoten wird der Inhalt des Dokuments ohne Markup als Folge von Textknoten in Document Order ausgegeben.
  
  
• Template für Elemente und Dokumentwurzel innerhalb eines Modus
  
  <xsl:template match="* | /" mode="m">
    <xsl:apply-templates mode="m" />
  </xsl:template>
  
  Wie oben, der Modus m wird durchgereicht.
  
  
• Template für Character Data und Attributwerte
  
  <xsl:template match="text() | @*">
    <xsl:value-of select="."/>
  </xsl:template>
  
  Die Regel "kopiert" den Wert des Character Data-Knotens oder des Attributs in das Zieldokuments.
  
  
• Template für Processing Instructions und Kommentare
  
  <xsl:template match="processing-instruction() | comment()"/>
  
  Dieses Template macht gar nichts. Processing Intructions und Kommentare werden also nicht ins Zieldokument übernommen.

---

xsl:call-template

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

Mittels xsl:call-template ist es möglich, gezielt bestimmte Template Rules auszuführen. Der Inhalt des Templates wird an der aktuellen Stelle im Zieldokument instanziiert, wobei sich der Current Node des XSLT-Prozessors nicht ändert.

Beispiel:

<xsl:call-template name="tabellenkopf">
  <xsl:with-param name="align">right</xsl:with-param>
</xsl:call-template>

---

Übergabe von Parametern

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