HTML/XHTML  »  Guide  »  Guida XHTML 

In questa lezione vedremo quali sono le fondamentali regole di funzionamento di un foglio XSLT Nella prossima, dove analizzeremo il foglio definito per X-blog, scenderemo maggiormente nei dettagli: affrontando un caso concreto: faremo una specie di anatomia di un documento XSL.

Struttura di base

Un foglio di stile XSLT è un documento XML, pertanto è sottoposto alle stesse regole sintattiche: deve essere insomma un documento valido. La struttura minima contiene due parti:

• il prologo
• l'elemento radice

Nel prologo si specifica in genere solo la dichiarazione XML:

<?xml version="1.0">

Per essa valgono le stesse regole già viste per XHTML.

Subito dopo il prologo è necessario dichiarare l'elemento radice. In un documento XSL l'elemento radice è <xsl:stylesheet>. Esso deve contenere un attributo che definisca la versione del linguaggio e almeno una dichiarazione di namespace. Quest'ultima ha come valore: "http://www.w3.org/1999/XSL/Transform".

La struttura di base di un foglio XSLT si presenta dunque così:

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
....................................
</xsl:stylesheet>

Tra il tag di apertura e quello di chiusura dell'elemento radice vanno definite tutte le regole di trasformazione.

Scegliere il metodo di output

Prima della definizione delle regole di trasformazione è possibile specificare il formato del documento finale. Ciò avviene tramite la dichiarazione <xsl:output>. All'interno di tale dichiarazione si possono specificare vari attributi. Il più importante è certamente method, con cui si può impostare il formato di output scegliendo tra xml, html e text:

<xsl:output method="html"/>

Altri attributi consentono di definire il DOCTYPE con la relativa DTD, la dichirazione XML, la scelta della codifica dei caratteri. Ne vedremo un esempio concreto nella nostra applicazione.

Regole e templates

Un foglio di stile XSLT vede un documento XML come un albero fatto di nodi. Torniamo al file "news.xml" (listato 6). Nella figura 1 abbiamo evidenziato graficamente la sua struttura:

<news> è l'elemento radice; <post> è un suo elemento figlio. <data>, <titolo> e <testo> sono sullo steso livello, ma tutti sono figli di <post>. L'elemento <link> è un nodo figlio di <testo>. Esso ha anche un attributo: href.

Un processore XSLT può trattare sette tipi di nodi presenti in un documento XML:

• l'elemento radice
• gli attributi e i loro valori
• i commenti
• gli elementi
• i namespace
• le istruzioni di elaborazione
• il testo contenuto in un nodo

Ora, in un foglio XSLT è necessario specificare delle regole per trasformare i singoli nodi. Ogni regola viene definita in un template. Quando si crea un template è come se si dicesse: caro processore XSL, quando incontri il nodo x esegui questa trasformazione. Esempio. Supponiamo di voler trasformare "news.xml" in XHTML e che l'elemento <testo> con il suo contenuto debba essere racchiuso in un paragrafo. In XSL creeremo questo template:

<xsl:template match="post">
<p><xsl:value-of select="testo"/></p>
</xsl:template>

Il processore percorrerà tutto l'albero del documento. Quando incontrerà l'elemento <post>, verificherà che <testo> sia presente come elemento figlio, trasformerà il testo in un paragrafo.

Rintracciare i nodi

Per individuare i singoli nodi si ricorre alla sintassi Xpath. Per capire come funziona Xpath si può fare riferimento al modo in cui si individuano file e cartelle in un file-system. Se scrivo: C:documentiritratto.jpg significa che individuo:

• un elemento radice (C:)
• una cartella al suo interno
• un file all'interno della cartella

Se volessi specificare il path per l'elemento <testo> del file news.xml scriverei così in Xpath:

<xsl:template match="news/post/testo">

La sintassi Xpath è notevolmente più complessa e se ben usata consente di individuare e trasformare ogni aspetto di documenti XML, anche molto complessi.

Elementi principali

Elenchiamo ora alcuni dei più importanti tag XSLT specificando per ciascuno la funzione. È solo un breve elenco, ma potrà darvi un'idea delle potenzialità di questo linguaggio. Per approfondimenti vi rimandiamo alla sezione "Riferimenti" della lezione precedente, mentre per un uso concreto di alcuni di essi, vi aspetta la prossima lezione.

xsl:apply-templates	Applica le regole definite in un tamplate.
xsl:attribute	Crea un attributo per un elemento.
xsl:comment	Genera un commento nel documento finale
xsl:element	Crea un nuovo elemento
xsl:for-each	Stabilisce una struttura ciclica ripetendo un template tutte le volte che un dato nodo viene incontrato.
xsl:if	Usato per impostare semplici strutture condizionali.
xsl:include	Include un foglio XSL esterno
xsl:sort	Ordina un insieme di nodi in bse ai parametri forniti.
xsl:stylesheet	Elemento radice di un documento XSL
xsl:template	Genera un template.
xsl:text	Genera nuovo testo nel documento di output
xsl:value-of	Restituisce il valore di un elemento o di un attributo.
xsl:when	Usato per espressioni condizionali complesse

Per maggiori informazioni su XSLT rimandiamo alla Guida XSLT pubblicata su HTML.it.

Altri articoli

Altre guide

Altre newsletter