Opmerking:
De gebruikersinterface van Dreamweaver CC en hoger is vereenvoudigd. Daarom zijn sommige opties die in dit artikel worden beschreven, niet beschikbaar in Dreamweaver CC en hoger. Meer informatie vindt u in dit artikel.
U kunt server-side XSL-transformaties op de server uitvoeren. Lees meer over server-side en client-side XSL-transformaties en over het gebruik van XML en XSL bij webpagina's voordat u pagina's gaat bouwen die XML-gegevens weergeven.
Opmerking:
Uw server moet correct zijn geconfigureerd voor het uitvoeren van server-side transformaties. Neem contact op met de serverbeheerder voor meer informatie.
De algemene workflow voor het uitvoeren van server-side XSL-transformaties is als volgt (elke stap is in andere onderwerpen beschreven).
Maak bijvoorbeeld een pagina die verwerking vereist en zorg ervoor dat de toepassingsserver de pagina verwerkt.
Maak op uw Dreamweaver-site een XSLT-fragment of een hele XSLT-pagina.
Zet een bestaande HTML-pagina om in een hele XSLT-pagina.
7. Voeg zo nodig een herhalingsgebied voor het XSLT-object toe aan de tabel of de tabelrij met de tijdelijke aanduidingen voor XML-gegevens.
Gebruik het servergedrag voor XSL-transformatie voor het invoegen van een verwijzing naar een XSLT-fragment in een dynamische pagina.
Om een verwijzing naar de hele XSLT-pagina in de dynamische pagina in te voegen, verwijdert u alle HTML-code van een dynamische pagina en gebruikt u het servergedrag voor XSL-transformatie.
Publiceer zowel de dynamische pagina als het XSLT-fragment (of de hele XSLT-pagina) naar de toepassingsserver. Als u een lokaal XML-bestand gebruikt, moet ook dit gepubliceerd worden.
De toepassingsserver transformeert dan de XML-gegevens, voegt deze aan de dynamische pagina toe en geeft ze in de browser weer.
U kunt XSLT-pagina's maken waarmee u XML-gegevens kunt weergeven op webpagina's. U kunt een hele XSLT-pagina maken (een XLST-pagina die een <body>-code en een <head>-code bevat), of u kunt een XSLT-fragment maken. Als u een XSLT-fragment maakt, maakt u een onafhankelijke bestand dat geen body- of head-code bevat; een eenvoudig stukje code dat later wordt ingevoegd in een dynamische pagina.
Opmerking:
Als u begint met een bestaande XSLT-pagina, moet u daar een XML-gegevensbron aan koppelen.
-
Klik op Maken en voer een van de volgende handelingen uit in het dialoogvenster XML-bron lokaliseren:
- Selecteer Lokaal bestand koppelen, klik op Bladeren, ga naar een lokaal XML-bestand op uw computer en klik op OK.
- Kies Extern bestand koppelen, voer de URL in van een XML-bestand op internet (bijvoorbeeld een van een RSS-bron) en klik op OK.
Opmerking:
Als u op de knop Annuleren klikt, wordt een nieuwe XSLT-pagina zonder gekoppelde XML-gegevensbron gegenereerd.
Het deelvenster Bindingen
De volgende tabel bevat een uitleg van de verschillende elementen in het schema die kunnen worden weergegeven:
Element
Vertegenwoordigt
Details
<>
Verplicht niet-herhalend XML-element
Een element dat precies één keer voorkomt binnen het bovenliggende knooppunt
<>+
Herhalend XML-element
Een element dat een of meer keer voorkomt binnen het bovenliggende knooppunt
<>+
Optioneel XML-element
Een element dat nul of meer keer voorkomt binnen het bovenliggende knooppunt
Vetgedrukt elementknooppunt
Huidig contextelement
Normaal gesproken het herhalende element als de invoegpositie in een herhalende regio staat
@
XML-kenmerk
U kunt ook bestaande HTML-pagina's omzetten naar XSLT-pagina's. Als u bijvoorbeeld een vooraf ontworpen statische pagina hebt waaraan u XML-gegevens wilt toevoegen, kunt u de pagina omzetten naar een XSLT-pagina in plaats van een XSLT-pagina te maken en deze volledig zelf op te bouwen.
Als u met een bestaande XSLT-pagina start of geen XML-gegevensbron koppelt wanneer u een nieuwe XSLT-pagina maakt met Dreamweaver, moet u een XML-gegevensbron koppelen via het deelvenster Bindingen.
Nadat u een XSLT-pagina hebt gemaakt en een XML-gegevensbron hebt gekoppeld, kunt u gegevens aan de pagina binden. Daarvoor moet u een tijdelijke aanduiding voor XML-gegevens aan de pagina toevoegen en vervolgens met de XPath Expression Builder of met de eigenschappencontrole de geselecteerde gegevens opmaken die op de pagina worden weergegeven.
-
Kies Invoegen > Tabel om een tabel aan de pagina toe te voegen (optioneel). Een tabel helpt u bij het ordenen van uw XML-gegevens.
Opmerking:
Doorgaans kunt u Herhalingsgebied XSLT-object gebruiken om herhalende XML-elementen op een pagina weer te geven. Ditmaal zou u een tabel met één rij en een of meer kolommen of een tabel met twee rijen kunnen maken als u een tabelkop wilt opnemen.
-
In het paneel Bindingen kiest u een XML-element en sleept het naar een plaats op de pagina waar u gegevens wilt invoegen.
Een XML-element selecteren in het deelvenster Bindingen
Op de pagina verschijnt een tijdelijke aanduiding voor XML-gegevens. Deze aanduiding wordt gemarkeerd en staat tussen accolades. De XPath-syntaxis (XML Path-taal) wordt gebruikt om de hiërarchische structuur van het XML-schema te beschrijven. Als u bijvoorbeeld het onderliggende element title naar de pagina sleept en dat element de bovenliggende elementen rss, channel en item heeft, is de syntaxis van de tijdelijke aanduiding voor de dynamische inhoud rss/channel/item/title.
Dubbelklik op de tijdelijke aanduiding voor XML-gegevens op de pagina om XPath Expression Builder te openen. Met XPath Expression Builder kunt u geselecteerde gegevens opmaken en andere items in het XML-schema selecteren.
-
(Optioneel) Pas stijlen toe op uw XML-gegevens door een tijdelijke aanduiding voor XML-gegevens te selecteren en er, zoals bij elk ander deel van de inhoud, stijlen op toe te passen met de eigenschappencontrole of het deelvenster CSS-stijlen. U kunt ook Design-Time stijlpagina's gebruiken om stijlen toe te passen op XSLT-fragmenten. Beide methoden hebben hun eigen voordelen en beperkingen.
Met Herhalingsgebied XSLT-object kunt u herhalende elementen van een XML-bronbestand op een webpagina herhalen. Als u bijvoorbeeld titels van artikelen en beschrijvingen van een nieuwsbron met 10 tot 20 artikelen weergeeft, is elke titel en beschrijving in het XML-bestand waarschijnlijk een onderliggend element van een herhalend element.
Elk gebied in de ontwerpweergave met een tijdelijke aanduiding voor XML-gegevens kan gewijzigd worden in een herhaald gebied. De meest voorkomende gebieden zijn echter een tabel, tabelrij of een reeks tabelrijen.
-
Selecteer in de ontwerpweergave een of meerdere gebieden met tijdelijke aanduidingen voor XML-gegevens.
Ontwerpweergave
Opmerking:
Als u een gebied op de pagina nauwkeurig wilt selecteren, gebruikt u de tagkiezer in de linkerbenedenhoek van het documentvenster. Als het gebied bijvoorbeeld een tabel is, klikt u in de tabel op de pagina en daarna op de tag in de tagkiezer.
-
In het documentvenster verschijnt een dunne grijze omtrek met tab rond het herhaalde gebied. Als u uw werk in een browser bekijkt (Bestand > Voorvertoning in browser), verdwijnt de grijze omtrek, wordt de selectie uitgebreid en geeft deze de opgegeven herhalende elementen in het XML-bestand weer.
Als u het Herhalingsgebied XSLT-object aan de pagina toevoegt, wordt de lengte van de tijdelijke aanduiding voor de XML-gegevens in het documentvenster ingekort. Dat komt omdat Dreamweaver XPath voor de tijdelijke aanduiding voor de XML-gegevens bijwerkt, zodat dit gerelateerd is aan het pad van het herhalende element.
In de eigenschappencontrole kunt u een ander XML-knooppunt selecteren om het herhalingsgebied te maken.
Nadat u een Herhalingsgebied XSLT-object aan een gebied hebt toegevoegd, kunt u dit met de eigenschappencontrole bewerken.
Nadat u een XSLT-fragment hebt gemaakt, kunt u het met het servergedrag voor XSL-transformatie invoegen in een dynamische webpagina. Als u het servergedrag aan uw pagina toevoegt en de pagina in een browser bekijkt, voert een toepassingsserver een transformatie uit die de XML-gegevens van het geselecteerde XSLT-fragment weergeeft. Dreamweaver ondersteunt XSL-transformaties voor ColdFusion-, ASP- of PHP-pagina's.
Opmerking:
Als u de inhoud van een hele XSLT-pagina in een dynamische pagina wilt invoegen, is de procedure hetzelfde. Voordat u servergedrag voor XSL-transformatie gebruikt om de hele XSLT-pagina in te voegen, moet u alle HTML-code verwijderen uit de dynamische pagina.
-
Opmerking:
Bij het invoegen van XSLT-fragmenten dient u altijd op Code- en ontwerpweergaven tonen te klikken nadat u de invoegpositie op de pagina hebt geplaatst, om te zorgen dat de invoegpositie op de juiste plaats staat. Als dat niet het geval is, kunt u elders in codeweergave klikken om de invoegpositie op de gewenste plaats te zetten.
-
Upload de dynamische pagina naar uw server (Site > Plaatsen) en klik op Ja om de afhankelijke bestanden op te nemen. Het bestand met het XSLT-fragment, het XML-bestand met uw gegevens en het gegenereerde runtime bibliotheekbestand moeten alle op de server aanwezig zijn om de pagina correct te kunnen weergeven. (Als u een extern XML-bestand als gegevensbron hebt geselecteerd, moet dat bestand zich elders op internet bevinden.)
U kunt een XSLT-fragment uit een pagina verwijderen door het servergedrag voor XSL-transformatie te verwijderen dat gebruikt is voor het invoegen van het fragment. Door het servergedrag te verwijderen, wordt alleen het XSLT-fragment verwijderd, niet de bijbehorende XML-, XSLT- en runtime bibliotheekbestanden.
Nadat u een XSLT-fragment aan een dynamische webpagina hebt toegevoegd, kunt u te allen tijde het servergedrag voor XSL-transformatie bewerken.
U kunt een dynamische koppeling op uw XSLT-pagina maken die verwijst naar een specifieke URL als de gebruiker op een bepaald woord of een groep woorden in uw XML-gegevens klikt. Zie de Dreamweaver-errata op www.adobe.com/go/dw_documentation_nl voor de volledige instructies.
Als u een hele XSLT-pagina maakt (dat wil zeggen een XSLT-pagina met <body>- en <head>-tags), kunt u XML-gegevens op de pagina weergeven en de gegevens met de eigenschappencontrole of het deelvenster CSS-stijlen opmaken zoals elk ander deel van de inhoud. Als u een XSLT-fragment maakt om dit in een dynamische pagina in te voegen (bijvoorbeeld in een ASP-, PHP- of ColdFusion-pagina), is het weergeven van stijlen in het fragment en in de dynamische pagina echter iets gecompliceerder. Hoewel u afzonderlijk en buiten de dynamische pagina om aan een XSLT-fragment werkt, is het belangrijk eraan te denken dat het fragment bedoeld is voor gebruik binnen de dynamische pagina en dat de uitvoer van het XSLT-fragment uiteindelijk ergens tussen de <body>-tags van de dynamische pagina terechtkomt. Bij deze workflow moet u goed opletten dat u geen <head>-elementen (zoals stijldefinities en koppelingen naar externe stijlpagina's) in XSLT-fragmenten opneemt. Anders plaatst de toepassingsserver deze elementen in de <body> van de dynamische pagina en genereert dan een ongeldige opmaak.
Stel dat u een XSLT-fragment wilt maken dat in een dynamische pagina wordt ingevoegd en het fragment opmaakt met dezelfde externe stijlpagina als de dynamische pagina. Als u dezelfde stijlpagina aan het fragment koppelt, bevat de resulterende HTML-pagina een dubbele koppeling naar de stijlpagina (een in de <head>-sectie van de dynamische pagina en een andere in de <body>-sectie van de pagina, waarin de inhoud van het XSLT-fragment verschijnt). In plaats van deze benadering te kiezen dient u Design-Time stijlpagina's te gebruiken voor verwijzing naar de externe stijlpagina.
Gebruik bij het opmaken van de inhoud van XSLT-fragmenten de volgende workflow.
Koppel eerst een externe stijlpagina aan de dynamische pagina. (Dit is de beste werkwijze voor het toepassen van stijlen op de inhoud van elke webpagina.)
Koppel vervolgens dezelfde externe stijlpagina aan het XSLT-fragment als een Design-Time stijlblad. Zoals de naam aangeeft, werken Design-Time stijlpagina's alleen in de ontwerpweergave van Dreamweaver.
Nadat u de vorige twee stappen hebt uitgevoerd, kunt u nieuwe stijlen maken in uw XSLT-fragment met dezelfde stijlpagina als u aan uw dynamische pagina hebt gekoppeld. De HTML-uitvoer zal schoner zijn (omdat de verwijzing naar de stijlpagina alleen geldig is terwijl u in Dreamweaver werkt) en het fragment zal toch de juiste stijlen weergeven in de ontwerpweergave. Bovendien worden al uw stijlen toegepast op zowel het fragment als de dynamische pagina wanneer u de dynamische pagina in de ontwerpweergave bekijkt of in een browser voorvertoont.
Opmerking:
Als u het XSLT-fragment in een browser voorvertoont, geeft deze de stijlen niet weer. In plaats daarvan dient u de dynamische pagina in de browser voor te vertonen om het XSLT-fragment in de context van de dynamische pagina te zien.
Bij het toevoegen van het servergedrag voor XSL-transformatie aan een webpagina kunt u parameters voor uw XSL-transformatie definiëren. Een parameter regelt hoe XML-gegevens worden verwerkt en weergegeven. U kunt bijvoorbeeld een parameter gebruiken om een bepaald artikel van een nieuwsbron aan te duiden en op te nemen. Als de pagina in een browser wordt geladen, verschijnt alleen het door u met de parameter opgegeven artikel.
-
Als u een statische waarde wilt gebruiken, typt u deze in het vak Waarde.
Als u een dynamische waarde wilt gebruiken, klikt u op het dynamische pictogram naast het vak Waarde, vult u het dialoogvenster Dynamische gegevens in en klikt u op OK. Klik op Help in het dialoogvenster Dynamische gegevens voor meer informatie.
U kunt enkel- en meervoudige voorwaardelijke gebieden maken op een XSLT-pagina. U kunt in de ontwerpweergave een element selecteren en daarop een voorwaardelijk gebied toepassen en u kunt een voorwaardelijk gebied invoegen op de plaats van de invoegpositie in het document.
Als u bijvoorbeeld naast de prijs van een uitverkocht artikel het woord “Uitverkocht" wilt plaatsen, typt u “Uitverkocht" op de pagina, selecteert u het woord en past u daarna een voorwaardelijk gebied toe op de geselecteerde tekst. Dreamweaver plaatst de selectie tussen <xsl:if>-tags en geeft het woord “Uitverkocht" alleen op de pagina weer als de gegevens voldoen aan de voorwaarden van de voorwaardelijke expressie.
U kunt een enkelvoudige voorwaardelijke expressie schrijven en in uw XSLT-pagina invoegen. Als de inhoud geselecteerd is wanneer u het dialoogvenster Voorwaardelijk gebied opent, wordt de inhoud door een <xsl:if>-blok omsloten. Als de inhoud niet is geselecteerd, wordt het <xsl:if>-blok toegevoegd op de plaats van de invoegpositie op de pagina. U kunt het beste met het dialoogvenster beginnen en de expressie daarna in codeweergave aan te passen.
Het <xsl:if>-element komt overeen met de if-instructie in andere talen. Door middel van het element kunt u een voorwaarde testen en op basis van het resultaat een bepaalde actie nemen. Met het <xsl:if>-element kunt u een expressie testen voor een enkelvoudige waarde van waar of onwaar.
-
<xsl:if test="@available='true'"> Content goes here </xsl:if>Opmerking:
Tekenreekswaarden als “true" moet u tussen aanhalingstekens plaatsen. Dreamweaver codeert de aanhalingstekens voor u (') zodat deze als geldige XHTML worden ingevoerd.
Naast het testen van waarden van knooppunten kunt u alle ondersteunde XSLT-functies in een voorwaardelijke expressie gebruiken. De voorwaarde wordt getest voor het huidige knooppunt in uw XML-bestand. In het volgende voorbeeld wilt u het laatste knooppunt in de resultaten testen.
Test voor het laatste knooppunt in de resultatenset
U kunt een enkelvoudige voorwaardelijke expressie schrijven en in uw XSLT-pagina invoegen. Als de inhoud geselecteerd is wanneer u het dialoogvenster Voorwaardelijk gebied opent, wordt de inhoud door een <xsl:if>-blok omsloten. Als u geen inhoud selecteert, wordt het <xsl:choose>-blok toegevoegd op de plaats van de invoegpositie op de pagina. Het is raadzaam om met het dialoogvenster te beginnen en de expressie daarna in codeweergave aan te passen.
Het <xsl:choose>-element komt overeen met de case-instructie in andere talen. Door middel van het element kunt u een voorwaarde testen en op basis van het resultaat een bepaalde actie nemen. Met het <xsl:choose>-element kunt u meervoudige voorwaarden testen.
Doel van de eigenschappencontrole Voorwaardelijk gebied instellen is het wijzigen van de in een voorwaardelijk gebied van uw XSL-pagina gebruikte voorwaarde. Het voorwaardelijke gebied test de voorwaarde en neemt een bepaalde actie op basis van het resultaat.
Doel van de eigenschappencontrole Voorwaardelijk gebied instellen is het wijzigen van de in een voorwaardelijk gebied van uw XSL-pagina gebruikte meervoudige voorwaarde. Het meervoudige voorwaardelijke gebied test de voorwaarde en neemt een bepaalde actie op basis van het resultaat.
U kunt XSL-commentaartags aan een document toevoegen en een selectie in XSL-commentaartags omsluiten.
-
Kies in de ontwerpweergave Invoegen > XSLT-objecten > XSL-commentaar, typ de opmerking (of laat het vak leeg) en klik op OK.
Kies in codeweergave Invoegen > XSLT-objecten > XSL-commentaar.
Opmerking:
U kunt ook op het pictogram XSL-commentaar klikken in de categorie XSLT van het deelvenster Invoegen.
XPath (XML Path Language) is een niet-XML syntaxis voor het adresseren van delen van een XML-document. Deze syntaxis wordt meestal als een querytaal voor XML-gegevens gebruikt, zoals SQL wordt gebruik voor het zoeken naar gegevens in databases. Zie de taalspecificatie XPath op de W3C-website van www.w3.org/TR/xpath voor meer informatie over XPath.
XPath Expression Builder is een Dreamweaver-functie waarmee u enkelvoudige XPath-expressies kunt bouwen voor het aanduiden van specifieke knooppunten en herhalingsgebieden. Deze methode heeft, vergeleken met het slepen van waarden vanuit het XML-schema, als voordeel dat u de weergegeven waarde kunt opmaken. De huidige context wordt aangeduid op basis van de invoegpositie in het XSL-bestand wanneer het dialoogvenster XPath Expression Builder wordt geopend. De huidige context heeft een vet lettertype in het XML-schema. Als u in deze dialoog selecties maakt, worden ten aanzien van uw huidige context de juiste XPath-instructies gegenereerd. Dat vereenvoudigt het schrijven van correcte XPath-expressies, zowel voor beginnende als gevorderde gebruikers.
Opmerking:
Deze functie is bedoeld om u te helpen bij het bouwen van enkelvoudige XPath-expressies voor het aanduiden van een bepaald knooppunt of van herhalingsgebieden. U kunt de expressies hiermee niet handmatig bewerken. Als u meervoudige expressies moet maken, begint u met XPath Expression Builder en past de expressies aan in codeweergave of met de eigenschappencontrole.
-
Selecteer in het dialoogvenster XPath Expression Builder (dynamische tekst) een knooppunt in het XML-schema.
Opmerking:
Als u een ander knooppunt in het XML-schema kiest, wordt de expressie aan uw keuze aangepast.
In het Opmerking: Tekenreekswaarden als “true" moet u tussen aanhalingstekens plaatsen. Dreamweaver codeert de olgende voorbeeld wilt u het subelement price van het knooppunt item weergeven.
Het dialoogvenster XPath Expression Builder (dynamische tekst)
<xsl:value-of select="price"/>
-
Opmaken van een selectie is handig wanneer het knooppunt een getal als waarde retourneert. Dreamweaver biedt een vooraf gedefinieerde lijst van opmaakfuncties. Zie het paneel Referenties voor een volledige lijst van opmaakfuncties en voorbeelden.
In het volgende voorbeeld wilt u het subelement price opmaken als een valuta met twee decimalen.
Het prijssubelement opmaken als een valuta met twee decimalen
Met deze opties wordt de volgende code ingevoegd op uw XSLT-pagina:<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
U kunt een knooppunt selecteren om te herhalen en de resultaten eventueel filteren. In het dialoogvenster XPath Expression Builder wordt de geselecteerde inhoud omsloten binnen een <xsl:for-each>-blok. Als u geen inhoud hebt geselecteerd, wordt het <xsl:for-each>-blok ingevoerd op de plaats van de invoegpositie.
-
Selecteer in het dialoogvenster XPath Expression Builder (herhalingsgebied) het item dat herhaald moet worden in het XML-schema.
Opmerking:
Herhalende items worden in het XML-schema aangeduid met een plusteken (+).
Het dialoogvenster XPath Expression Builder (herhalingsgebied)
<xsl:for-each select="provider/store/items/item"> Content goes here </xsl:for-each>
-
Filteren op
Geeft het herhalende knooppunt met de gegevens waarop u wilt filteren. Het pop-upmenu biedt een lijst van bovenliggende knooppunten ten opzichte van het knooppunt dat u in het XML-schema hebt geselecteerd.
Waar
Geeft het kenmerk of het subelement van het knooppunt voor Filteren op dat gebruikt wordt om de resultaten te beperken. U kunt een kenmerk of subelement in het pop-upmenu selecteren en u kunt in dit veld uw eigen XPath-expressie invoeren om onderliggende elementen aan te duiden die lager liggen in het schema.
-
Als u waarden invoert of iets in de pop-upmenu's selecteert, wordt XPath-expressie in het vak Expressie aangepast.
In het volgende voorbeeld wilt u de resultaten beperken tot die item-knooppunten waarbij de waarde van het kenmerk @available true (waar) is.
De resultaten beperken tot die item-knooppunten waarbij de waarde van het kenmerk @available true (waar) is
Als u op OK klikt, wordt de volgende code ingevoegd op uw XSLT-pagina:<xsl:for-each select="provider/store/items/item[@available = 'true']"> Inhoud komt hier </xsl:for-each>
<xsl:for-each select="provider/store/items/item[@available = 'true']"> Content goes here </xsl:for-each>Opmerking:
Tekenreekswaarden als “true" moet u tussen aanhalingstekens plaatsen. Dreamweaver codeert de aanhalingstekens voor u (') zodat deze als geldige XHTML worden ingevoerd.
U kunt meer complexe filters maken waarmee u bovenliggende knooppunten kunt opgeven als deel van uw filtercriteria. In het volgende voorbeeld wilt u de resultaten beperken tot die item-knooppunten waarbij het @id-kenmerk van de store gelijk is aan 1 en het price-knooppunt van het item groter is dan 5.
De resultaten beperken tot die item-knooppunten waarbij het @id-kenmerk van de store gelijk is aan 1 en het price-knooppunt van het item groter is dan 5
Als u op OK klikt, wordt de volgende code ingevoegd op uw XSLT-pagina:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Inhoud komt hier </xsl:for-each>
Zie de sectie <xsl:for-each> in het deelvenster Referentie voor meer informatie en voorbeelden van desbetreffende herhalingsgebieden.
<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Content goes here </xsl:for-each>
De voorwaarden van Creative Commons zijn niet van toepassing op Twitter™- en Facebook-berichten.