XSL Templates. Mit Templates arbeiten. XSL Templates

Transkript

1 XSL Templates Mit Templates arbeiten Innerhalb von XSLT werden Templates verwendet. Ein Template ist eine Vorlage für die Transformation bestimmter Knoten. Diese Knoten können Elemente, Attribute oder auch Text sein. Vorlagen werden durch das xsl:template-element erstellt und beschrieben. Es besitzt unter anderem die Attribute match und name. Letzteres definiert einen eindeutigen Namen für das Template, der später weiter verwendet werden kann. Mit dem match-attribut wird exakt spezifiziert, auf welche Knoten der Quell-Datei diese Vorlage angewandt werden soll. Die Werte dieses Attributes werden als Pattern bezeichnet. Folgende Patterns sind unter anderem möglich: Elementname Wert Beschreibung Wird ein Elementname oder eine durch verbundene Liste von Elementnamen definiert, gilt die Vorlage für alle benannten Elemente innerhalb der Liste. / Das root-element wird verwendet. Elementname1/Elementname2 Elementname1//Elementname2 id(name) key(name,wert) text() Wird auf alle Elementname2 angewandt, die Elementname1 als Eltern-Element haben. Wird auf alle Elementname2 angewandt, die Elementname1 als Vorfahren-Element (z.b. Eltern- Element oder Eltern-Element vom Eltern-Element usw.) haben. Wird auf alle Elemente angewandt, die die ID Name haben. Wird auf alle Elemente angewandt, die durch einen Schlüssel (xsl:key) mit dem jeweiligen Namen definiert werden und den Wert haben. Wird auf alle Text-Knoten angewandt. 1 / 9

2 processing-instruction() node() Elementname[n] Wird auf alle PI's angewandt. Wird auf alle Knoten angewandt, die keine Attribute oder das Root- Element sind. Wird auf alle Elemente Elementname angewandt, wenn sie das n-te Element innerhalb des Elternelements sind. * Alle Knoten werden verwendet. position() = Elementname [@Attributname="Wert"]// Alle Elemente mit der Positionsnummer x werden verwendet. Auch sind Rechenformeln denkbar: position() mod 4 = 0 (jeder 4te Knoten) Alle Attribut-Knoten mit dem Namen Name. Alle Elemente mit dem Attributwert Wert des Attributes Attributname. Dies ist nur eine kleine Auswahl der wichtigsten Pattern. XSLT definiert hier noch unzählige weitere und erlaubt darüber hinaus auch die Kombination mit/und XPath ausdrücke/n. Gelangt der XSLT-Parser zu einem Knoten, für den ein Template definiert wurde, ersetzt er diesen Knoten durch das Template. Innerhalb des Templates können dazu weitere XSLT-Angaben oder auch Text oder Markup folgen. Diese werden dann als weitere Knoten angesehen und ebenfalls abgeschritten. Beispiel xml-quelle: <?xml-stylesheet href="trans1.xsl" type="text/xsl"?> <!DOCTYPE A [ <!ELEMENT A (#PCDATA B)*> <!ELEMENT B (#PCDATA C)*> <!ELEMENT C EMPTY> ]> <A> </A> <B> </B> <C /> 2 / 9

3 Das XSLT-Stylesheet: <xsl:template match="a"> <Element<b>A</b>> <xsl:apply-templates /> </Element<b>A</b>> <xsl:template match="b"> <Element<b>B</b>> <xsl:apply-templates /> </Element<b>B</b>> <xsl:template match="c"> <Element<b>C</b>/> Werden die obigen Daten auf das darunterstehende Style Sheet angewandt, so erhält man folgendes Ergebniss: <ElementA> <ElementB> <ElementC> <ElementB> <ElementA> Templates in Templates Durch die Verschachtelung von XML-Elementen wird es nötig, innerhalb eines Templates ein anderes verwenden zu können. Dies erfolgt über das xsl:apply-templates-element. Es besagt, dass an dieser Stelle andere Templates eingebunden werden können (sofern die entsprechenden Knoten existieren). Wird das Element als leeres Element notiert (siehe Beispiel oben) heißt dies, dass hier alle Vorlagen erscheinen können. Darüber hinaus kann der Vorlagenbereich auch eingeschränkt werden. Dies erfolgt über das select-attribut, welches als Wert wiederum einen Pattern erhalten kann (siehe 'Mit Templates arbeiten' -> Pattern). Auch können mehrere xsl:apply-templates- Elemente innerhalb eines xsl:template-elements enthalten sein. Beispiel Quelle: 3 / 9

4 <!DOCTYPE A [ <!ELEMENT A (#PCDATA B)*> <!ELEMENT B (#PCDATA C)*> <!ELEMENT C EMPTY> ]> <A> </A> <B> </B> <C /> Das XSLT-Style Sheet: <xsl:template match="a"> <p> </p> <p> </p> Der Inhalt von B wird ausgelassen,stattdessen folgt der Inhalt vonc: <xsl:apply-templates select="b/c" /> <xsl:template match="b"> Anfang B <xsl:apply-templates/> Ende B <xsl:template match="c"> Dies ist der Inhalt von C Erzeugt folgendes Bild: 4 / 9

5 Templates einbinden Um Templates auch an Stellen verwenden zu können, an denen es eigentlich nicht auftreten sollte (da z.b. keine entsprechenden Knoten vorhanden sind), benutzt man das xsl:call-template-element. Es erhält als Wert des name-attributes den Namen eines Templates, das an dieser Stelle eingebunden werden soll. Beispiel (es wird die obige Quelle verwendet): <?xml version="1.0"?> <xsl:template match="a"> <p>inhalt von C:</p> <p><b><xsl:call-template name="tempb" /></b></p> <xsl:template name="tempb" match="b"> Anfang B <xsl:apply-templates /> Ende B <xsl:template match="c"> Dies ist der Inhalt von C<br /> <xsl:call-template name="tempb" /> erzeugt folgendes Ergebnis: Inhalt von C: Anfang B Anfang B Dies ist der Inhalt von C Anfang B Ende B Ende B Ende B 5 / 9

6 Mehrere Style Sheets verwenden Es gibt zwei Wege, um in einem XSLT-Dokument die Angaben eines anderen verwenden zu können. Im ersten Fall benutzt man dazu das xsl:include-element. Als Wert des href-attributes erhält dies die URL der zu verwendenden Datei. Diese wird eingelesen und die enthaltenen Angaben werden in das aktuelle Dokument eingebunden (an der Stelle an der der Aufruf stattfand). Im zweiten Fall benutzt man das xsl:import-element. Auch hier wird das href-attribut mit der jeweiligen URL definiert. Der Unterschied zu xsl:include besteht darin, dass die Regeln des importierten Style Sheets Vorrang vor denen aus dem eigentlichen Dokument haben. Ein Beispiel: <xsl:import href="trans1.xsl"/> <xsl:import href="trans2.xsl"/> <xsl:include href="inc1.xsl"/> <!--... <xsl:import href="inc2.xsl"/> <! > Bitte beachten Sie, dass beide Elemente nur als Top-Level Element verwendbar sind. Außerdem sollten die xsl:import-elemente vor allen anderen Elementen definiert werden - xsl:include- Elemente können danach überall auf root-ebene vertreten sein. Elemente erzeugen XSLT bietet zum Erzeugen der Resultate vorgefertigte Lösungen (/Elemente). Diese werden angewandt, um eine saubere Syntax des Resultat-Dokuments zu erhalten und um Knoten zu erzeugen, die innerhalb der Quelle schonverwendet wurden. Elemente werden mit xsl:element erzeugt. Dies besitzt die Attribute 1. name (Name des Elements) 2. namespace (Namensraum des Elements) sowie 6 / 9

7 3. use-attribute-sets (Name der zu verwendenden Attributliste). Der Name muss definiert werden - der Namespace und die Attributliste stehen frei. Innerhalb des xsl:element-elements können beliebige Informationen (Text, Markup, Kommentare...) folgen. Beispiel: <xsl:element name="meinelement"> Das ist mein Element. </xsl:element> erzeugt: <MeinElement> Das ist mein Element. </MeinElement> Attribute erzeugen So, wie Elemente erzeugt werden können, ist es auch möglich, diesen Attribute zuzuweisen. Dazu verwendet man das xsl:attribute-element. Es erhält als Wert des name-attributes den zu verwendenden Namen sowie bei Bedarf ein Namespace-Attribut. Innerhalb des Elements wird der Wert des erzeugten Attributes notiert. Beispiel: <xsl:element name="meinelement"> <xsl:attribute name="meinattribut">meinwert</xsl:attribute> <p> <xsl:attribute name="align">right</xsl:attribute> Das ist mein Element. </p> </xsl:element>... erzeugt: <MeinElement MeinAttribut="MeinWert"> <p align="right"> Das ist mein Element. </p> </MeinElement> Bitte beachten Sie, das das Element nur innerhalb eines 1. xsl:element- 2. xsl:attribute-set- 3. definierten Elements 7 / 9

8 verwendet werden kann. Außerdem sollten Sie darauf achten, dass die Attribut-Definition ohne Zwischentext direkt nach der Element-Definition stehen sollte. Attributlisten Mit Attributlisten kann man häufig verwendete Attribute schneller verwenden, indem man sie einem Element über use-attribute-sets zuweist und nicht jedes Mal neu definieren muss. Attributlisten werden durch das Element xsl:attribute-set definiert und beinhalten ausschließlich Attribute (xsl:attribute). Außerdem müssen sie durch das name-attribut mit einem Namen versehen werden, der dann von Elementen verwendet werden kann. Ein Quellbeispiel: <?xml-stylesheet href="trans.xsl" type="text/xsl"?> <!DOCTYPE A [ <!ELEMENT A ( B )*> <!ELEMENT B EMPTY> ]> <A> </A> <B /> Das Style Sheet: <xsl:attribute-set name="liste1"> <xsl:attribute name="align">right</xsl:attribute> <xsl:attribute name="style">color:red;</xsl:attribute> </xsl:attribute-set> <xsl:attribute-set name="liste2" use-attribute-sets="liste1"> <xsl:attribute name="src">meinbild.gif</xsl:attribute> </xsl:attribute-set> <xsl:template match="a"> <xsl:element name="h3" use-attribute-sets="liste1"> Attributlisten 8 / 9

9 </xsl:element> <hr /> <xsl:apply-templates/> <xsl:template match="b"> <xsl:element name="img" use-attribute-sets="liste2" />... erzeugt: <h3 align="right" style="color:red;"> Attributlisten </h3> <hr> <img align="right" style="color:red;" src="meinbild.gif"> 9 / 9