Eseguire trasformazioni XSL server-side in Dreamweaver

Ultimo aggiornamento il 20 dic 2021

Eseguire trasformazioni XSL server-side in Dreamweaver. Creare pagine XSLT e convertire HTML in pagine XSLT.

L’interfaccia utente di Dreamweaver e versioni successive è stata semplificata. Di conseguenza, potreste non trovare alcune delle opzioni descritte in questo articolo in Dreamweaver e versioni successive. Per ulteriori informazioni, consultate questo articolo.

Flusso di lavoro per eseguire trasformazioni XSL lato server

Puoi eseguire trasformazioni XSL lato server sul server. Leggi le informazioni sulle trasformazioni XSL lato server e lato client e sull'utilizzo di XML e XSL con le pagine web prima di generare pagine che visualizzano dati XML.

è necessario che il server sia correttamente configurato per effettuare trasformazioni server-side. Per altre informazioni, consultate l'amministratore del server.

Il flusso di lavoro generale per eseguire trasformazioni XSL lato server è il seguente (ogni passaggio è descritto in altri argomenti):

1.Imposta un sito Dreamweaver.

2.Scegli una tecnologia server e configura un server applicazioni.

3.Testa il server applicazioni.

Ad esempio, crea una pagina che richiede elaborazione e assicurati che il server applicazioni elabori la pagina.

4. Crea un frammento o una pagina XSLT oppure converti una pagina HTML in una pagina XSLT.

  • Nel sito Dreamweaver, crea un frammento XSLT o un'intera pagina XSLT.

  • Convertite una pagina HTML esistente in una pagina XSLT intera.

5.Collega un'origine dati XML alla pagina.

6. Visualizza i dati XML tramite l'associazione dei dati al frammento XSLT o all'intera pagina XSLT.

7. Se necessario, aggiungi un oggetto XSLT Repeating Region alla tabella o alla riga della tabella che contiene i segnaposto dei dati XML.

8.Inserisci riferimenti.

  • Per inserire un riferimento al frammento XSLT nella pagina dinamica, utilizza il comportamento server Trasformazione XSL.

  • Per inserire un riferimento all'intera pagina XSLT nella pagina dinamica, elimina tutto il codice HTML da una pagina dinamica, quindi utilizza il comportamento server Trasformazione XSL.

9.Pubblica la pagina e il frammento.

Pubblica sia la pagina dinamica che il frammento XSLT (o l'intera pagina XSLT) sul server applicazioni.Se stai utilizzando un file XML locale, dovrai pubblicare anche quello.

10.Visualizza la pagina dinamica in un browser.

In questo modo, il server applicazioni trasforma i dati XML, li inserisce nella pagina dinamica e li visualizza nel browser.

Creare una pagina XSLT

Puoi creare pagine XSLT che ti permettono di visualizzare dati XML su pagine web. Puoi creare sia un'intera pagina XSLT—una pagina XSLT che contiene un tag <body> e un tag <head>—oppure puoi creare un frammento XSLT. Quando crei un frammento XSLT, crei un file indipendente che non contiene tag body o head—un semplice pezzo di codice che viene successivamente inserito in una pagina dinamica.

se partite da una pagina XSLT esistente, dovete collegare un'origine dati XML.

Selezionate File > Nuovo.
Nella categoria Pagina vuota della finestra di dialogo Nuovo documento seleziona una delle seguenti opzioni dalla colonna Tipo di pagina:
  • Seleziona XSLT (Intera pagina) per creare un'intera pagina XSLT.

  • Selezionate XSLT (frammento) per creare un frammento XSLT.

Fai clic su Crea ed effettua una delle seguenti operazioni nella finestra di dialogo Individua origine XML:
  • Selezionate Associa un file locale, fate clic sul pulsante Sfoglia, individuate un file XML locale sul computer e fate clic su OK.
  • Selezionate Associa un file remoto, inserite l'URL di un file XML su Internet (ad esempio da un feed RSS) e fate clic su OK.

fate clic sul pulsante Annulla per generare una nuova pagina XSLT con nessuna origine dati XML collegata.

Il pannello Associazioni viene compilato con lo schema dell'origine dati XML

Pannello Associazioni

Nella tabella seguente vengono illustrati i vari elementi dello schema che potrebbe venire visualizzato:

Elemento

Rappresenta

Dettagli

<>

Elementi XML necessari non ripetuti

Elemento che viene visualizzato solo una volta all'interno del nodo di origine

<>+

Elemento XML ripetuto

Elemento che viene visualizzato una o più volte all'interno del nodo di origine

<>+

Elemento XML facoltativo

Elemento che viene visualizzato zero o più volte all'interno del nodo di origine

Elemento nodo in carattere grassetto

Elemento di contesto corrente

Normalmente l'elemento ripetuto quando il punto di inserimento è all'interno di un'area ripetuta

@

Attributo XML

 

 

Salva la nuova pagina (File > Salva) con l'estensione .xsl o .xslt (.xsl è l'impostazione predefinita).

Convertire pagine HTML in pagine XSLT

Puoi anche convertire le pagine HTML esistenti in pagine XSLT.Ad esempio, se hai una pagina statica preimpostata alla quale vuoi aggiungere dati XML, puoi convertire la pagina in una pagina XSLT, invece di creare una pagina XSLT e riprogettarla da zero.

Aprite la pagina HTML da convertire.
Seleziona File > Converti > XSLT 1.0.

Una copia della pagina viene aperta nella finestra del documento. La nuova pagina è un foglio di stile XSL, salvato con l'estensione .xsl.

Collegare origini dati XML

Se stai iniziando con una pagina XSLT esistente, o se non colleghi un'origine dati XML durante la creazione di una nuova pagina XSLT con Dreamweaver, devi collegare un'origine dati XML usando il pannello Associazioni.

Nel pannello Associazioni (Finestra > Associazioni), fai clic sul collegamento XML.
Nel pannello Associazioni, fate clic su XML

per aggiungere un'origine dati XML potete anche fare clic sul collegamento Origine nell'angolo superiore destro del pannello Associazioni.

Effettuate una delle operazioni seguenti:
  • Seleziona Collega un file locale, fai clic sul pulsante Sfoglia, cerca un file XML locale sul computer e fai clic su OK.

  • Seleziona Collega un file remoto e inserisci l'URL di un file XML su Internet (ad esempio uno proveniente da un feed RSS).

Fate clic su OK per chiudere la finestra di dialogo Individua origine XML.

Il pannello Associazioni viene popolato con lo schema XML dell'origine dati XML.

Visualizzare i dati XML nelle pagine XSLT

Dopo aver creato una pagina XSLT e collegato un'origine dati XML, puoi associare i dati alla pagina.Per farlo, aggiungi un segnaposto di dati XML alla tua pagina e poi usa il generatore di espressioni XPath o il pannello Proprietà per formattare i dati selezionati che verranno visualizzati nella pagina.

Aprite una pagina XSLT con un'origine dati XML collegata.
(Facoltativo) Seleziona Inserisci > Tabella per aggiungere una tabella alla pagina.L'uso di una tabella facilita l'organizzazione dei dati XML.
Nota

Nella maggior parte dei casi, usi l'oggetto XSLT Area ripetuta per visualizzare gli elementi XML ripetuti in una pagina.In questo caso, potresti voler creare una tabella a riga singola con una o più colonne, o una tabella a due righe se vuoi includere un'intestazione di tabella.

Nel pannello Associazioni, seleziona un elemento XML e trascinalo nel punto della pagina in cui vuoi inserire i dati.
Selezionate un elemento XML nel pannello Associazioni

Un segnaposto di dati XML viene visualizzato nella pagina.Il segnaposto è evidenziato e tra parentesi graffe.Usa la sintassi XPath (linguaggio percorso XML) per descrivere la struttura gerarchica dello schema XML.Ad esempio, se trascini l'elemento secondario title nella pagina, e quell'elemento ha gli elementi principali rss, channel e item, allora la sintassi per il segnaposto contenuto dinamico sarà {rss/channel/item/title}.

Fai doppio clic sul segnaposto di dati XML nella pagina per aprire il Generatore di espressioni XPath.Il Generatore di espressioni XPath ti consente di formattare i dati selezionati, o selezionare altri elementi dallo schema XML.

(Facoltativo) Applica stili ai dati XML selezionando un segnaposto di dati XML e applicando gli stili come a qualsiasi altro elemento di contenuto usando la finestra di ispezione Proprietà o il pannello Stili CSS.In alternativa, puoi utilizzare i fogli di stile Design-time per applicare gli stili ai frammenti XSLT.Ciascuno di questi metodi presenta vantaggi e limitazioni specifici.
Mostra anteprima del lavoro in un browser (File > Anteprima nel browser).

quando usate il comando Anteprima nel browser per visualizzare l'anteprima del lavoro, Dreamweaver esegue una trasformazione XSL interna senza ricorrere a un server applicazioni.

Visualizzare gli elementi XML ripetuti

L'oggetto XSLT Area ripetuta consente di visualizzare elementi ripetuti da un'origine dati XML in una pagina web.Ad esempio, se visualizzi titoli e descrizioni di articoli da un feed di notizie che contiene tra 10 e 20 articoli, ogni titolo e descrizione nel file XML sarebbe probabilmente un elemento figlio di un elemento ripetuto.

Qualsiasi area nella vista Progettazione che contenga un segnaposto per dati XML può essere trasformata in un'area ripetuta.Tuttavia, le aree più comuni sono tabelle, righe di tabelle o una serie di righe di tabelle.

Nella vista Progettazione, seleziona un'area che contiene un segnaposto o segnaposti per dati XML.

La selezione può essere qualsiasi elemento, inclusa una tabella, una riga di tabella o anche un paragrafo di testo.

Vista Progettazione

per selezionare un'area della pagina con precisione, potete utilizzare il selettore di tag presente nell'angolo inferiore sinistro della finestra del documento. Ad esempio, se l'area è in una tabella, fate clic all'interno della tabella nella pagina, quindi sul tag nel selettore di tag.

Effettuate una delle operazioni seguenti:
  • Seleziona Inserisci > Oggetti XSLT > Area ripetuta.

  • Nella categoria XSLT del pannello Inserisci, fai clic sul pulsante Area ripetuta.

Nel Generatore di espressioni XPath, seleziona l'elemento ripetuto, indicato da un piccolo segno più.
Creazione espressioni XPath

Fate clic su OK.

Nella finestra Documento, un contorno grigio, sottile e con linguette appare intorno all'area ripetuta.Quando visualizzi l'anteprima del lavoro in un browser (File > Anteprima nel browser), il contorno grigio scompare e la selezione si espande per mostrare gli elementi ripetuti specificati nel file XML.

Quando aggiungi l'oggetto XSLT Area ripetuta alla pagina, il segnaposto per dati XML nella finestra Documento viene troncato.Questo succede perché Dreamweaver tronca il percorso XPath per il segnaposto dei dati XML in modo che sia relativo al percorso dell'elemento ripetuto.

Impostare le proprietà dell'area ripetuta (XSL)

Nel pannello Proprietà puoi selezionare un nodo XML diverso per creare la regione ripetuta.

Nella casella Seleziona, inserisci un nuovo nodo, quindi premi l'icona del fulmine e seleziona il nodo dall'albero dello schema XML che appare.

Modificare un oggetto XSLT Area ripetuta

Dopo aver aggiunto un oggetto Area ripetuta XSLT a un'area, puoi modificarlo utilizzando il pannello Proprietà.

Seleziona l'oggetto facendo clic sulla linguetta grigia che circonda l'area ripetuta.
Nel pannello Proprietà (Finestra > Proprietà), fai clic sull'icona dinamica accanto al campo di testo Seleziona.
Nel Generatore di espressioni XPath, apporta le modifiche e fai clic su OK.

Inserire frammenti XSLT nelle pagine dinamiche

Dopo aver creato un frammento XSLT, puoi inserirlo in una pagina web dinamica utilizzando il comportamento server Trasformazione XSL.Quando aggiungi il comportamento server alla pagina e visualizzi la pagina in un browser, un server applicazioni esegue una trasformazione che mostra i dati XML dal frammento XSLT selezionato.Dreamweaver supporta le trasformazioni XSL per pagine ColdFusion, ASP o PHP.

se desiderate inserire il contenuto di una pagina XSLT intera in una pagina dinamica, la procedura è identica. Prima di utilizzare il comportamento server Trasformazione XSL per inserire la pagina XSLT intera, eliminare tutto il codice HTML dalla pagina dinamica.

Aprite una pagina ColdFusion, ASP o PHP esistente.
Nella vista Progettazione, posiziona il punto di inserimento nel punto in cui desideri inserire il frammento XSLT.

quando inserite frammenti XSLT, dovete sempre fare clic sul pulsante Mostra viste Codice e Progettazione dopo aver collocato il punto di inserimento sulla pagina in modo da poter verificare che il punto di inserimento sia nella posizione corretta. In caso contrario, potrebbe essere necessario fare clic in un altro punto della vista Codice per collocare il punto di inserimento nella posizione desiderata.

Nel pannello Comportamenti server (Finestra > Comportamenti server), fai clic sul pulsante Più (+) e seleziona Trasformazione XSL.
Pannello Comportamenti server

Nella finestra di dialogo Trasformazione XSL, fai clic sul pulsante Sfoglia e vai a un frammento XSLT o a una pagina XSLT completa.

Dreamweaver compila il campo di testo successivo con il percorso file o l'URL del file XML collegato al frammento specificato. Per cambiarlo, fai clic sul pulsante Sfoglia e vai a un altro file.

(Opzionale) Fate clic sul pulsante più (+) per aggiungere un parametro XSLT.
Fai clic su OK per inserire un riferimento al frammento XSLT nella pagina. Il frammento non è modificabile direttamente. Puoi fare doppio clic sul frammento per aprire il file di origine del frammento e modificarlo.

Viene creata anche una cartella includes/MM_XSLTransform/ nella cartella radice del sito che contiene un file di libreria runtime.Il server dell'applicazione utilizza le funzioni definite in questo file per eseguire la trasformazione.

Carica la pagina dinamica sul server (Sito > Pubblica) e fai clic su Sì per includere i file correlati.Il file contenente il frammento XSLT, il file XML contenente i dati e il file libreria runtime generato devono trovarsi tutti sul server perché la pagina venga visualizzata correttamente. (Se hai selezionato un file XML remoto come origine dati, il file deve risiedere altrove su Internet.)

Eliminare frammenti XSLT da pagine dinamiche

Puoi rimuovere un frammento XSLT da una pagina eliminando il comportamento server Trasformazione XSL utilizzato per inserire il frammento. L'eliminazione del comportamento server elimina solo il frammento XSLT, non elimina i file XML, XSLT o di libreria runtime associati.

Nel pannello Comportamenti server (Finestra > Comportamenti server), seleziona il comportamento server Trasformazione XSL che desideri eliminare.
Fate clic sul pulsante meno (-).

è necessario eliminare i comportamenti server sempre in questo modo. L'eliminazione manuale del codice generato rimuove solo parzialmente il comportamento server, anche se questo non compare più nel pannello Comportamenti server.

Modificare comportamenti server Trasformazione XSL

Dopo aver aggiunto un frammento XSLT a una pagina web dinamica, puoi modificare il comportamento server di trasformazione XSL in qualsiasi momento.

Nel pannello Comportamenti server (Finestra > Comportamenti server), fai doppio clic sul comportamento server Trasformazione XSL che desideri modificare.
Apportate le modifiche, quindi fate clic su OK.

Puoi creare un collegamento dinamico nella pagina XSLT che porta a un URL specifico quando l'utente fa clic su una parola specifica o un gruppo di parole nei dati XML.Per istruzioni complete, consulta l'errata corrige di Dreamweaver su www.adobe.com/go/dw_documentation.

Applicazione di stili a frammenti XSLT

Quando crei un'intera pagina XSLT (ovvero una pagina XSLT che contiene tag <body> e <head>), puoi visualizzare i dati XML sulla pagina e poi formattare i dati come qualsiasi altro pezzo di contenuto utilizzando la finestra di ispezione Proprietà o il pannello Stili CSS. Tuttavia, quando crei un frammento XSLT per l'inserimento in una pagina dinamica (ad esempio, un frammento per l'inserimento in una pagina ASP, PHP o Cold Fusion), il rendering degli stili nel frammento e nella pagina dinamica diventa più complicato. Sebbene lavori su un frammento XSLT separatamente dalla pagina dinamica, è importante ricordare che il frammento è destinato all'uso all'interno della pagina dinamica e che l'output del frammento XSLT alla fine risiede da qualche parte all'interno dei tag <body> della pagina dinamica. Dato questo flusso di lavoro, è importante assicurarsi di non includere elementi <head> (come definizioni di stile o collegamenti a fogli di stile esterni) nei frammenti XSLT. In caso contrario, il server dell'applicazione inserisce questi elementi nel <body> della pagina dinamica, generando markup non valido.

Ad esempio, puoi creare un frammento XSLT per l'inserimento in una pagina dinamica e formattare il frammento utilizzando lo stesso foglio di stile esterno della pagina dinamica.Se colleghi lo stesso foglio di stile al frammento, la pagina HTML risultante contiene un collegamento duplicato al foglio di stile (uno nella sezione <head> della pagina dinamica e un altro nella sezione <body> della pagina, dove appare il contenuto del frammento XSLT). Invece di questo approccio, devi utilizzare i fogli di stile della fase di progettazione per fare riferimento al foglio di stile esterno.

Per formattare il contenuto dei frammenti XSLT, utilizza il seguente flusso di lavoro:

  • Innanzitutto, collegate un foglio di stile esterno alla pagina dinamica. (Questa è una procedura ottimale per l'applicazione degli stili al contenuto di qualsiasi pagina Web.)

  • Quindi, collegate lo stesso foglio di stile esterno per il frammento XSLT come foglio di stile Fase di progettazione. Come dice il nome, i fogli di stile Fase di progettazione sono disponibili solo nella vista Progettazione di Dreamweaver.

    Una volta completati i passaggi precedenti, potete creare nuovi stili nel frammento XSLT utilizzando lo stesso foglio di stile collegato alla pagina dinamica. Otterrete un output HTML più pulito (in quanto il riferimento al foglio di stile è valido solo mentre si lavora in Dreamweaver) e il frammento verrà comunque visualizzato negli stili corretti in vista Progettazione. Inoltre, tutti gli stili vengono applicati al frammento e alla pagina dinamica quando visualizzate la pagina dinamica in vista Progettazione o un'anteprima della pagina dinamica in un browser.

se visualizzate un'anteprima del frammento XSLT in un browser, il browser non mostra gli stili. Per vedere il frammento XSLT nel contesto della pagina dinamica, è necessario visualizzare l'anteprima della pagina dinamica nel browser.

Utilizzare i parametri con le trasformazioni XSL

Puoi definire parametri per la trasformazione XSL quando aggiungi il comportamento server Trasformazione XSL a una pagina web. Un parametro controlla il modo in cui i dati XML vengono elaborati e visualizzati. Ad esempio, potresti utilizzare un parametro per identificare ed elencare un articolo specifico da un feed di notizie. Quando la pagina si carica in un browser, appare solo l'articolo specificato con il parametro.

Aggiungere un parametro XSLT a una trasformazione XSL

Aprite la finestra di dialogo Trasformazione XSL. Puoi farlo facendo doppio clic su un comportamento server Trasformazione XSL nel pannello Comportamenti server (Finestra > Comportamenti server) o aggiungendo un nuovo comportamento server Trasformazione XSL.
Nella finestra di dialogo Trasformazione XSL, fai clic sul pulsante più (+) accanto a Parametri XSLT.
Finestra di dialogo Trasformazione XSL

Nella finestra di dialogo Aggiungi parametri, inserisci un nome per il parametro nella casella Nome. Il nome può contenere solo caratteri alfanumerici. non può includere spazi.
Effettuate una delle operazioni seguenti:
  • Se vuoi utilizzare un valore statico, inseriscilo nella casella Valore.

  • Se vuoi utilizzare un valore dinamico, fai clic sull'icona dinamica accanto alla casella Valore, completa la finestra di dialogo Dati dinamici e fai clic su OK. Per ulteriori informazioni, fai clic sul pulsante Aiuto nella finestra di dialogo Dati dinamici.

Nella casella Valore predefinito, inserisci il valore che vuoi che il parametro utilizzi se la pagina non riceve alcun valore di runtime, quindi fai clic su OK.

Modificare un parametro XSLT

Aprite la finestra di dialogo Trasformazione XSL. Puoi farlo facendo doppio clic su un comportamento del server di trasformazione XSL nel pannello Comportamenti server (Finestra > Comportamenti server) o aggiungendo un nuovo comportamento del server di trasformazione XSL.
Selezionate un parametro dall'elenco Parametri XSLT.
Fate clic sul pulsante Modifica.
Apportate le modifiche, quindi fate clic su OK.

Eliminare un parametro XSLT

Aprite la finestra di dialogo Trasformazione XSL. Puoi farlo facendo doppio clic su un comportamento server Trasformazione XSL nel pannello Comportamenti server (Finestra > Comportamenti server) o aggiungendo un nuovo comportamento server Trasformazione XSL.
Selezionate un parametro dall'elenco Parametri XSLT.
Fate clic sul pulsante meno (-).

Crea e modifica aree XSLT condizionali

Puoi creare aree condizionali semplici o multiple in una pagina XSLT. Puoi selezionare un elemento nella vista Progettazione e applicare un'area condizionale alla selezione, oppure puoi inserire un'area condizionale ovunque si trovi il punto di inserimento nel documento.

Ad esempio, se volessi visualizzare la parola "Non disponibile" accanto al prezzo di un articolo quando l'articolo non è disponibile, digiti il testo "Non disponibile" nella pagina, lo selezioni e quindi applichi un'area condizionale al testo selezionato. Dreamweaver racchiude la selezione con i tag <xsl:if> e visualizza solo la parola «Non disponibile» nella pagina quando i dati corrispondono alle condizioni dell'espressione condizionale.

Applicare un'area XSLT condizionale

Puoi scrivere un'espressione condizionale semplice da inserire nella pagina XSLT. Se il contenuto è selezionato quando apri la finestra di dialogo Area condizionale, il contenuto viene racchiuso in un blocco <xsl:if>. Se il contenuto non è selezionato, il blocco <xsl:if> viene aggiunto al punto di inserimento della pagina. È una buona idea utilizzare la finestra di dialogo per iniziare e quindi personalizzare l'espressione nella vista Codice.

L'elemento <xsl:if> è simile al costrutto if di altri linguaggi.L'elemento fornisce un modo per testare una condizione ed eseguire un'azione in base al risultato. L'elemento <xsl:if> consente di testare un'espressione per verificare se il valore è vero o falso.

Seleziona Inserisci > Oggetti XSLT > Area condizionale oppure fai clic sull'icona Area condizionale nella categoria XSLT del pannello Inserisci.
Nella finestra di dialogo Area condizionale, inserisci l'espressione condizionale da utilizzare per l'area.

Nell'esempio seguente, vuoi testare se il valore dell'attributo @available del nodo di contesto è vero.

Finestra di dialogo Area condizionale

Fate clic su OK.

Il codice seguente viene inserito nella pagina XSLT:

<xsl:if test="@available=&apos;true&apos;">

    Inserite qui il contenuto 

</xsl:if>

è necessario inserire i valori di stringa come true tra virgolette. Dreamweaver codifica le virgolette (&apos;) in modo che vengano inserite come XHTML valido.

Oltre a testare i nodi per i valori, puoi utilizzare qualsiasi funzione XSLT supportata in qualsiasi istruzione condizionale. La condizione viene verificata per il nodo corrente all'interno del file XML. Nell'esempio seguente, vuoi testare l'ultimo nodo nel set di risultati:

Test per verificare l'ultimo nodo nel set di risultati

Per ulteriori informazioni ed esempi su come scrivere espressioni condizionali, consulta la sezione <xsl:if> nel pannello Riferimenti (Aiuto > Riferimenti).

Applica più regioni XSLT condizionali

Puoi scrivere un'espressione condizionale semplice da inserire nella pagina XSLT. Se il contenuto è selezionato quando apri la finestra di dialogo Area condizionale, il contenuto viene racchiuso in un blocco <xsl:choose>. Se non selezioni il contenuto, il blocco <xsl:choose> viene aggiunto al punto di inserimento della pagina. È consigliabile utilizzare la finestra di dialogo per iniziare e quindi personalizzare l'espressione nella vista Codice.

L'elemento <xsl:choose> è simile all'istruzione case di altri linguaggi. L'elemento fornisce un modo per testare una condizione ed eseguire un'azione in base al risultato.L'elemento <xsl:choose> ti consente di testare più condizioni.

Seleziona Inserisci > Oggetti XSLT > Area condizionale multipla oppure fai clic sull'icona Area condizionale multipla nella categoria XSLT del pannello Inserisci.
Nella finestra di dialogo Area condizionale multipla, inserisci la prima condizione.

Nell'esempio seguente, vuoi verificare se il sottoelemento price del nodo di contesto è inferiore a 5.

Finestra di dialogo Area condizionale multipla

Fate clic su OK.

Nell'esempio, il codice seguente viene inserito nella pagina XSLT:

<xsl:choose>

<xsl:when test="price<5">

        Inserite qui il contenuto 

</xsl:when>

<xsl:otherwise>

        Inserite qui il contenuto 

</xsl:otherwise>

</xsl:choose>

Per inserire un'altra condizione, posiziona il punto di inserimento nella vista Codice tra le coppie di tag <xsl:when> o appena prima del tag <xsl:otherwise>, quindi inserisci un'area condizionale (Inserisci > Oggetti XSLT > Area condizionale).

Dopo aver specificato la condizione e fatto clic su OK, un altro tag <xsl:when> viene inserito nel blocco <xsl:choose>.

Per ulteriori informazioni ed esempi sulla scrittura di espressioni condizionali, consulta le sezioni <xsl:choose> nel pannello Riferimento (Aiuto > Riferimento).

Proprietà dell'area condizionale (If)

Lo scopo della finestra di ispezione Proprietà area condizionale è di modificare la condizione utilizzata in un'area condizionale nella pagina XSL.L'area condizionale verifica la condizione e intraprende un'azione in base al risultato.

Nella casella Test, inserisci una nuova condizione, quindi premi Invio.

Proprietà dell'area condizionale (When)

Lo scopo della finestra di ispezione Proprietà Imposta area condizionale è cambiare la condizione utilizzata in un'area condizionale multipla nella pagina XSL. L'area condizionale multipla verifica la condizione e intraprende un'azione in base al risultato.

Nella casella Test, inserisci una nuova condizione, quindi premi Invio.

Inserire commenti XSL

Puoi aggiungere tag di commento XSL a un documento oppure puoi racchiudere una selezione nei tag di commento XSL.

Aggiungere tag di commento XSL a un documento

Effettuate una delle operazioni seguenti:
  • Nella vista Progettazione, seleziona Inserisci > Oggetti XSLT > Commento XSL, digita il contenuto del commento (o lascia vuota la casella) e fai clic su OK.

  • Nella vista Codice, seleziona Inserisci > Oggetti XSLT > Commento XSL.

Nota

Puoi anche fare clic sull'icona Commento XSL nella categoria XSLT del pannello Inserisci.

Racchiudere una selezione nei tag di commento XSL

Passa alla vista Codice (Visualizza > Codice).
Selezionate il codice da commentare.
Nella barra degli strumenti Codificazione, fai clic sul pulsante Applica Commento e seleziona Applica <xsl:comment></xsl:comment> Commento.

Utilizza il Generatore di espressioni XPath per aggiungere espressioni per i dati XML

XPath (XML Path Language) è una sintassi non-XML per indirizzare porzioni di un documento XML. Viene utilizzato principalmente come linguaggio di richiesta per i dati XML, proprio come il linguaggio SQL viene utilizzato per interrogare i database. Per ulteriori informazioni su XPath, consulta la specifica del linguaggio XPath sul sito web W3C all'indirizzo www.w3.org/TR/xpath.

Il Generatore di espressioni XPath è una funzionalità di Dreamweaver che consente di creare semplici espressioni XPath per identificare nodi specifici di dati e per le aree ripetute. Il vantaggio di utilizzare questo metodo invece di trascinare i valori dall'albero dello schema XML è che puoi formattare il valore che viene visualizzato. Il contesto corrente viene identificato in base alla posizione del punto di inserimento nel file XSL quando viene aperta la finestra di dialogo del Generatore di espressioni XPath. Il contesto corrente viene visualizzato in grassetto nella struttura dello schema XML. Quando effettui le selezioni all'interno di questa finestra di dialogo, vengono generate le istruzioni XPath corrette, relative al contesto corrente.Questo semplifica il processo di scrittura di espressioni XPath corrette per principianti e utenti avanzati.

questa funzione è progettata per facilitare l'utente nella creazione di espressioni XPath semplici per identificare un nodo specifico o per le aree ripetute. Non consente di modificare le espressioni manualmente. Per creare espressioni complesse, utilizzate la finestra di dialogo Creazione espressioni XPath per iniziare e quindi personalizzate le espressioni nella vista Codice o mediante la finestra di ispezione Proprietà.

Crea un'espressione XPath per identificare un nodo specifico

Fai doppio clic sul segnaposto dei dati XML sulla pagina per aprire il Generatore di espressioni XPath.
Nella finestra di dialogo Generatore di espressioni XPath (Testo dinamico), seleziona qualsiasi nodo nell'albero dello schema XML.

L'espressione XPath corretta viene scritta nella casella Espressione per identificare il nodo.

Nota

Se selezioni un nodo diverso nell'albero dello schema XML, l'espressione cambia per riflettere la tua scelta.

Nel seguente esempio, desideri visualizzare il sottoelemento price del nodo item:

Finestra di dialogo Creazione espressioni XPATH (testo dinamico)

Questa selezione inserisce il seguente codice nella pagina XSLT:

<xsl:value-of select="price"/>

(Facoltativo) Seleziona un'opzione di formattazione dal menu a comparsa Formato.

Formattare una selezione è utile quando il valore del nodo restituisce un numero. Dreamweaver fornisce un elenco predefinito di funzioni di formattazione. Per un elenco completo delle funzioni di formattazione disponibili e degli esempi, consulta il pannello Riferimento.

Nel seguente esempio, desideri formattare il sottoelemento price come valuta con due cifre decimali:

Formattazione del sottoelemento price come una valuta con due cifre decimali

Queste opzioni inseriscono il seguente codice nella pagina XSLT:<xsl:value-of select=&quot;format-number(provider/store/items/item/price,&apos;$#.00&apos;)&quot;/>

Fate clic su OK.
Per visualizzare il valore di ogni nodo nel file XML, applica un'area ripetuta all'elemento che contiene il testo dinamico (ad esempio, una riga di tabella HTML o un paragrafo).

Per ulteriori informazioni ed esempi su come selezionare nodi per restituire un valore, consulta la sezione <xsl:value-of/> nel pannello Riferimento.

Selezionare un nodo da ripetere

Puoi selezionare un nodo da ripetere e, facoltativamente, filtrare i risultati. Nella finestra di dialogo Generatore espressioni XPath, il contenuto selezionato verrà inserito in un blocco <xsl:for-each>. Se non hai selezionato contenuto, il blocco <xsl:for-each> verrà inserito nel punto di inserimento del cursore.

Fai doppio clic sul segnaposto dati XML nella pagina per aprire il Generatore espressioni XPath.
Nella finestra di dialogo Generatore espressioni XPath (Area che si ripete), selezionare l'elemento da ripetere nell'albero dello schema XML.

L'espressione XPath corretta viene scritta nella casella Espressione per identificare il nodo.

Nota

Gli elementi che si ripetono sono identificati con un simbolo Più (+) nell'albero dello schema XML.

Nell'esempio seguente, vuoi ripetere ogni nodo item all'interno del file XML.

Finestra di dialogo Creazione espressioni XPATH (Area ripetuta)

Quando fai clic su OK, il codice seguente viene inserito nella pagina XSLT:

<xsl:for-each select="provider/store/items/item">

 Inserite qui il contenuto 

</xsl:for-each>

In alcuni casi, potresti voler lavorare con un sottoinsieme dei nodi che si ripetono, ad esempio, potresti volere solo elementi in cui un attributo ha un valore specifico. In questo caso, devi creare un filtro.

Filtrare i dati da ripetere

Usa un filtro per identificare nodi che si ripetono e che hanno valori di attributo specifici.

Nella struttura dello schema XML, selezionate un nodo da ripetere.
Fate clic sul pulsante di espansione Crea filtro.
Fate clic sul pulsante più (+) per creare un filtro vuoto.
Inserite il criterio di filtro nei campi seguenti:

Filtra per

Specifica il nodo che si ripete e che contiene i dati che vuoi filtrare. Il menu a comparsa fornisce un elenco di nodi superiori relativi al nodo selezionato nell'albero dello schema XML.

Posizione

Specifica l'attributo o il sottoelemento del nodo Filtra per che verrà usato per limitare i risultati. Puoi selezionare un attributo o sottoelemento dal menu a comparsa, oppure puoi inserire la tua espressione XPath in questo campo per identificare elementi secondari che esistono più in profondità all'interno dell'albero dello schema.

Operatore

Specifica l'operatore di confronto da usare nell'espressione del filtro.

Valore

Specifica il valore da verificare nel nodo Filtra per. Inserite il valore. Se sono definiti parametri dinamici per la pagina XSLT, puoi selezionarne uno dal menu a comparsa.

Per specificare un altro filtro, fai di nuovo clic sul pulsante Più (+).

Man mano che inserisci valori o fai selezioni nei menu a comparsa, l'espressione XPath nella casella Espressione cambia.

Nell'esempio seguente, vuoi limitare il set di risultati a quei nodi item in cui il valore dell'attributo @available è vero.

Limitare il set di risultati ai nodi di item in cui il valore dell'attributo @available è true

Quando fai clic su OK, il seguente codice viene inserito nella tua pagina XSLT:<xsl:for-each select=&quot;provider/store/items/item[@available = &apos;true&apos;]&quot;> Il contenuto va qui </xsl:for-each>

è necessario inserire i valori di stringa come true tra virgolette. Dreamweaver codifica le virgolette (&apos;) in modo che vengano inserite come XHTML valido.

Puoi creare filtri più complessi che ti consentono di specificare i nodi principali come parte dei criteri di filtro. Nel seguente esempio, vuoi limitare il set di risultati ai nodi item dove l'attributo @id del web store è uguale a 1 e il nodo prezzo dell'elemento è maggiore di 5.

Limitare il set di risultati ai nodi di item in cui il valore dell'attributo @id di store è uguale a 1 e il nodo price di item è maggiore di 5.

Quando fai clic su OK, il seguente codice viene inserito nella pagina XSLT:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Il contenuto va qui </xsl:for-each>

Per ulteriori informazioni ed esempi di regioni ripetute, consulta la sezione <xsl:for-each> nel pannello Riferimento.