XSLT - Der Aufbau eines Stylesheets

Übersicht: XSLT - Aufbau eines Stylesheets

• xsl:stylesheet
• xsl:import und xsl:include
• xsl:strip-space und xsl:preserve-space
• xsl:output
• xsl:namespace-alias
• Benannte Attributbausteine
• Literal Result Elements als Stylesheet
• Einbetten von Stylesheets
• Variablen, Parameter und Result Tree Fragments

xsl:stylesheet

Nachdem wir uns in den vorherigen Abschnitten die zentralen Elemente des Stylesheets, die Templates und Template Rules, angeschaut haben, wollen wir uns nun mit den restlichen Elementen des Stylesheets beschäftigen. Das Dokumentelement eines Stylesheets wird wie folgt definiert:

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

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

Das Konstrukt xsl:transform ist ein Synonym für xsl:stylesheet, einen Unterschied gibt es lediglich in ihrer Bedeutung für Dritte. Wenn es sich beim Stylesheet um eine Transformationsvorschrift handelt, ist xsl:transform die richtige Wahl, will man mit dem Stylesheet Ausgabeformatierungen mittels XSL-FO vornehmen, sollte man xsl:stylesheet verwenden.

Das version-Attribut muss angegeben werden. Hier hat man sich Gedanken über die Zukunft gemacht: Trifft ein XSLT-Prozessor auf ein Stylesheet, das Elemente einer höheren Version enthält als er selbst unterstützt, aktiviert er das so genannte Forward Compatible Processing. Damit bleibt sichergestellt, dass Stylesheets auch von älteren Prozessoren noch verarbeitet werden können.

Das Attribut extension-element-prefixes enthält eine Liste von Präfixen, durch Whitespaces getrennt. Elemente im Stylesheet mit diesen Präfixen werden als Extension Elements behandelt und nicht durch den XSLT-Prozessor sondern durch einen nicht näher definierten Prozess behandelt.

Über exclude-result-prefixes kann man Namespace-Präfixe deklarieren, die beim Erzeugen des Ergebnisdokumentes unterdrückt werden sollen.

Mittels des Attributs id schließlich kann man das Stylesheet-Element innerhalb einer anderen Ressource eindeutig identifizieren.

xsl:import und xsl:include

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

<xsl:import
  href = uri-reference />

Stylesheets können modularisiert werden. Hierzu gibt es zwei Möglichkeiten, nämlich xsl:include und xsl:import. Beide Anweisungen arbeiten auf der Baumebene, wobei das über das href-Attribut zu referenzierende Stylesheet als xml-Dokument behandelt und eine entsprechende Baumrepräsentation erzeugt wird. Diese wird dann an der Stelle der xsl:import- oder xsl:include-Anweisung in das aktuelle Stylesheet eingefügt. Dabei muss darauf geachtet werden, dass sich Stylesheets weder direkt noch indirekt selbst importieren oder inkludieren.

Der Unterschied liegt jetzt in der Behandlung der Templates bei Konflikten. Während ein inkludiertes Stylesheet die Reihenfolge der Template-Auflösung nicht ändert, bekommen importierte Templates eine niedrigere Importpräzedenz als die Templates des importierenden Stylesheets.

Imports müssen immer vor allen anderen Top Level-Elementen des Stylesheets auftreten. Hat ein inkludiertes Stylesheet ebenfalls Importanweisungen, werden diese hinter die Importanweisungen des inkludierenden Stylesheets gehängt.

Zuerst werden also die Inkludierungen ausgeführt. Anschließend werden die Imports so abgearbeitet, dass eine Art Importbaum entsteht. Importiert Stylesheet A die Stylesheets B und C, B importiert D, und C importiert E, ergibt sich folgender Baum:

Der beispielhafte Importbaum

Die Präzedenz ergibt sich aus diesem Baum, indem man erst die Nachfolger eines Knotens betrachtet und dann die Knoten selbst (von links nach rechts). Damit ergibt sich folgende Präzedenzfolge: D, B, E, C, A, wobei D die niedrigste und A die höchste Präzedenz hat.

Die Importpräzedenz hat Einfluss auf die Auswahl von Templates in Konfliktsituationen. Denn aus der Liste der möglichen Alternativen werden nur die Templates mit der höchsten Importpräzedenz berücksichtigt.

xsl:strip-space und xsl:preserve-space

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

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

Mit diesen beiden Konstrukten kann die Liste der Elemente im Quelldokument, die einem White Space Stripping unterworfen oder davon ausgenommen (preserve) werden sollen, modifiziert werden. Das Attribut elems enthält je eine Liste von Tokens, also Namen, die mit Whitespaces voneinander getrennt sind. Als Vorgabe sind alle Elemente des Quelldokuments vom Whitespace-Stripping ausgenommen.

xsl:output

<!-- 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 />

Mit xsl:output kann man das Ausgabeverhalten des XSLT-Prozessors beeinflussen.

Die Art und Weise wird über method festgelegt. Erlaubt sind hier die Werte xml, html und text sowie eine mögliche Ausgabemethode, über die in der Spezifikation nichts gesagt wird und die dann woanders festgelegt sein muss.

Weitere Attribute:

• version bestimmt die Version des Ausgabemethode, z.B. 4.0 für HTML 4.
• encoding bestimmt den Zeichencodierungstypen, also z.B. UTF-8 oder UTF-16.
• Hat omit-xml-declaration den Wert yes, wird im Fall der Ausgabe als XML-Dokument die XML-Deklaration unterdrückt.
• standalone bestimmt, ob das XML-Dokument in der XML-Deklaration mit standalone="yes" oder standalone="no" gekennzeichnet werden soll.
• doctype-public erzeugt den PUBLIC Identifier der Dokumenttypdeklaration des XML-Dokuments.
• doctype-system erzeugt den SYSTEM Identifier der Dokumenttypdeklaration des XML-Dokuments.
• cdata-section-elements ist eine Liste von Qualified Names, durch Whitespaces getrennt. Text Nodes von Elementen, die in dieser Liste angegeben werden, werden in einer CDATA-Sektion ausgegeben.
• Ist indent="yes" werden in die Ausgabe Einrückungen durch Whitespaces eingestreut, um die Lesbarkeit des Dokuments zu verbessern.
• media-type spezifiziert den MIME Type des Ausgabedatenstroms, also z.B. text/html bei HTML oder text/xml bei XML.

Der XSLT-Prozessor kann die Ausgabemethode auch durch Betrachtung des Ergebnisdokuments automatisch bestimmen.

<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>

<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>