Meer informatie over het uitvoeren van XSL-transformaties op de server in Dreamweaver. XSLT-pagina's maken en HTML omzetten naar XSLT-pagina's.

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.

Workflow voor het uitvoeren van server-side XSL-transformaties

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

1. Stel een Dreamweaver-site in.

2. Kies een servertechnologie en stel een toepassingsserver in.

3. Test de toepassingsserver.

Maak bijvoorbeeld een pagina die verwerking vereist en zorg ervoor dat de toepassingsserver de pagina verwerkt.

4. Maak een XSLT-fragment of -pagina of zet een HTML-pagina om in een XSLT-pagina.

  • Maak op uw Dreamweaver-site een XSLT-fragment of een hele XSLT-pagina.

  • Zet een bestaande HTML-pagina om in een hele XSLT-pagina.

5. Koppel een XML-gegevensbron aan de pagina.

6. Geef XML-gegevens weer door de gegevens aan het XSLT-fragment of de hele XSLT-pagina te binden.

7. Voeg zo nodig een herhalingsgebied voor het XSLT-object toe aan de tabel of de tabelrij met de tijdelijke aanduidingen voor XML-gegevens.

8. Voeg verwijzingen in.

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

9. Publiceer de pagina en het fragment.

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.

10. Bekijk de dynamische pagina in een browser.

De toepassingsserver transformeert dan de XML-gegevens, voegt deze aan de dynamische pagina toe en geeft ze in de browser weer.

XSLT-pagina maken

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.

  1. Selecteer Bestand > Nieuw.
  2. Selecteer in de categorie Lege pagina van het dialoogvenster Nieuw document een van de volgende opties in de kolom Paginatype:
    • Selecteer XSLT (hele pagina) om een hele XSLT-pagina te maken.

    • Selecteer XSLT (fragment) om een XSLT-fragment te maken.

  3. 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 wordt gevuld met het schema van uw XML-gegevensbron

    Het deelvenster Bindingen
    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

     

     

  4. Sla uw nieuwe pagina op (Bestand > Opslaan) met de extensie .xsl of .xslt (.xsl is de standaardextensie).

HTML-pagina's omzetten naar XSLT-pagina's

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.

  1. Open de HTML-pagina die u wilt omzetten.
  2. Kies Bestand > Omzetten > XSLT 1.0.

    In het documentvenster wordt een kopie van de pagina geopend. De nieuwe pagina is een XSL-stijlpagina, opgeslagen met de extensie .xsl.

XML-gegevensbronnen koppelen

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.

  1. Klik in het deelvenster Bindingen (Venster > Bindingen) op de XML-koppeling.
    Klik op XML in het deelvenster Bindingen
    Klik op XML in het deelvenster Bindingen

    Opmerking:

    U kunt ook op de koppeling Bron klikken rechtsboven in het paneel Bindingen om een XML-gegevensbron toe te voegen.

  2. Voer een van de volgende handelingen uit:
    • Selecteer Lokaal bestand koppelen, klik op Bladeren, ga naar een lokaal XML-bestand op uw computer en klik op OK.

    • Kies Extern bestand koppelen en voer de URL in van een XML-bestand op internet (bijvoorbeeld een URL van een RSS-bron).

  3. Klik op OK om het dialoogvenster XML-bron lokaliseren te sluiten.

    Het paneel Bindingen wordt gevuld met het schema van uw XML-gegevensbron.

XML-gegevens weergeven op XSLT-pagina's

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.

  1. Open een XSLT-pagina met de gekoppelde XML-gegevensbron.
  2. 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.

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

  4. (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.
  5. Bekijk uw werk in een browser (Bestand > Voorvertoning in browser).

    Opmerking:

    als u uw werk met Voorvertoning in browser bekijkt, voert Dreamweaver een interne transformatie uit zonder een toepassingsserver te gebruiken.

Herhalende XML-elementen weergeven

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.

  1. Selecteer in de ontwerpweergave een of meerdere gebieden met tijdelijke aanduidingen voor XML-gegevens.

    De selectie kan van alles zijn, een tabel, een tabelrij en zelfs een alinea tekst.

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

  2. Ga op een van de volgende manieren te werk
    • Kies Invoegen > XSLT-objecten > Herhalingsgebied.

    • Klik op Herhalingsgebied in de categorie XSLT van het deelvenster Invoegen.

  3. Selecteer in XPath Expression Builder het herhalende element dat door een klein plusteken aangeduid wordt.
    XPath Expression Builder
    XPath Expression Builder

  4. Klik op OK.

    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.

Eigenschappen herhalingsgebied instellen (XSL)

In de eigenschappencontrole kunt u een ander XML-knooppunt selecteren om het herhalingsgebied te maken.

  1. Voer in het vak Selecteren een nieuw knooppunt in, druk dan op het pictogram met de bliksemflits en selecteer het knooppunt uit het XML-schema dat verschijnt.

Herhalingsgebied XSLT-object bewerken

Nadat u een Herhalingsgebied XSLT-object aan een gebied hebt toegevoegd, kunt u dit met de eigenschappencontrole bewerken.

  1. Selecteer het object door op de grijze tab rond het herhaalde gebied te klikken.
  2. Klik in de eigenschappencontrole (Venster > Eigenschappen) op het dynamische pictogram naast het tekstveld Selecteren.
  3. Breng in XPath Expression Builder de wijzigingen aan en klik op OK.

XSLT-fragmenten invoegen in dynamische pagina's

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.

  1. Open een bestaande ColdFusion-, ASP-, of PHP-pagina.
  2. Plaats de invoegpositie in de ontwerpweergave op de plaats waar u het XSLT-fragment wilt invoegen.

    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.

  3. Klik in het deelvenster Servergedrag (Venster > Servergedrag) op de knop Plus (+) en kies XSL-transformatie.
    Het deelvenster Servergedrag
    Het deelvenster Servergedrag

  4. Klik in het dialoogvenster XSL-transformatie op Bladeren en blader naar een XSLT-fragment of een hele XSLT-pagina.

    Dreamweaver vult het volgende tekstveld met het bestandspad of de URL van het XML-bestand dat aan het opgegeven fragment is gekoppeld. Klik op Bladeren als u dit wilt wijzigen en ga naar een ander bestand.

  5. Klik op de plusknop (+) om een XSLT-parameter toe te voegen (optioneel).
  6. Klik op OK om een verwijzing naar het XSLT-fragment in de pagina in te voegen. Het fragment kan niet worden bewerkt. U kunt dubbelklikken op het fragment om het bronbestand ervan te openen en te bewerken.

    In de hoofdmap van de site wordt ook een map includes/MM_XSLTransform/ gemaakt met een runtime bibliotheekbestand. De toepassingsserver gebruikt de in dit bestand gedefinieerde functies voor het uitvoeren van de transformatie.

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

XSLT-fragmenten verwijderen uit dynamische pagina's

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.

  1. Selecteer in het paneel Servergedrag (Venster > Servergedrag) het servergedrag voor XSL-transformatie dat u wilt verwijderen.
  2. Klik op de minknop (-).

    Opmerking:

    Servergedrag moet u altijd op deze manier verwijderen. Door de gegenereerde code handmatig te verwijderen wordt het servergedrag slechts gedeeltelijk verwijderd, ook als het servergedrag uit het paneel Servergedrag verdwijnt.

Servergedrag voor XSL-transformaties bewerken

Nadat u een XSLT-fragment aan een dynamische webpagina hebt toegevoegd, kunt u te allen tijde het servergedrag voor XSL-transformatie bewerken.

  1. Dubbelklik in het deelvenster Servergedrag (Venster > Servergedrag) op het servergedrag voor XSL-transformatie dat u wilt bewerken.
  2. Breng de gewenste wijzigingen aan en klik op OK.

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.

Stijlen toepassen op XSLT-fragmenten

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.

Parameters met XSL-transformaties gebruiken

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.

XSLT-parameter aan een XSL-transformatie toevoegen

  1. Open het dialoogvenster XSL-transformatie. U kunt deze dialoog openen door te dubbelklikken op een servergedrag voor XSL-transformatie in het paneel Servergedrag (Venster > Servergedrag) of door een nieuw servergedrag voor XSL-transformatie toe te voegen.
  2. In het dialoogvenster XSL-transformatie klikt u op de knop Plus (+) naast XSLT-parameters.
    Het dialoogvenster XSL-transformatie
    Het dialoogvenster XSL-transformatie

  3. In het vak Naam in het dialoogvenster Parameter toevoegen typt u een naam voor de parameter. Deze naam mag alleen alfanumerieke tekens bevatten. Er mogen geen spaties in voorkomen.
  4. Voer een van de volgende handelingen uit:
    • 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.

  5. In het vak Standaardwaarde typt u de waarde die de parameter moet gebruiken als de pagina geen runtimewaarde ontvangt. Klik daarna op OK.

XSLT-parameter bewerken

  1. Open het dialoogvenster XSL-transformatie. U kunt deze dialoog openen door te dubbelklikken op een servergedrag voor XSL-transformatie in het paneel Servergedrag (Venster > Servergedrag) of door een nieuw servergedrag voor XSL-transformatie toe te voegen.
  2. Selecteer een parameter uit de lijst van XSLT-parameters.
  3. Klik op Bewerken.
  4. Breng de gewenste wijzigingen aan en klik op OK.

XSLT-parameter verwijderen

  1. Open het dialoogvenster XSL-transformatie. U kunt deze dialoog openen door te dubbelklikken op een servergedrag voor XSL-transformatie in het paneel Servergedrag (Venster > Servergedrag) of door een nieuw servergedrag voor XSL-transformatie toe te voegen.
  2. Selecteer een parameter uit de lijst van XSLT-parameters.
  3. Klik op de minknop (-).

Voorwaardelijke XSLT-gebieden maken en bewerken

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.

Voorwaardelijk XSLT-gebied toepassen

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.

  1. Selecteer Invoegen > XSLT-objecten > Voorwaardelijk gebied of klik op het pictogram Voorwaardelijk gebied in de categorie XSLT van het deelvenster Invoegen.
  2. Typ in het dialoogvenster Voorwaardelijk gebied de voorwaardelijke expressie voor het gebied.

    In het volgende voorbeeld wilt u testen of de waarde van het kenmerk @available van het contextknooppunt true (waar) is.

    Het dialoogvenster Voorwaardelijk gebied
    Het dialoogvenster Voorwaardelijk gebied

  3. Klik op OK.

    De volgende code wordt in de XSLT-pagina ingevoegd.

    <xsl:if test="@available=&apos;true&apos;"> 
        Content goes here 
    </xsl:if>

    Opmerking:

    Tekenreekswaarden als “true" moet u tussen aanhalingstekens plaatsen. Dreamweaver codeert de aanhalingstekens voor u (&apos;) 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
    Test voor het laatste knooppunt in de resultatenset

    Zie de sectie <xsl:if> in het paneel Referentie (Help > Referentie) voor meer informatie en voorbeelden desbetreffende het schrijven van voorwaardelijke expressies.

Meervoudige voorwaardelijke XSLT-gebieden toepassen

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.

  1. Selecteer Invoegen > XSLT-objecten > Meervoudig voorwaardelijk gebied of klik op het pictogram Meervoudig voorwaardelijk gebied in de categorie XSLT van het deelvenster Invoegen.
  2. Typ in het dialoogvenster Meervoudig voorwaardelijk gebied de eerste voorwaarde.

    In het volgende voorbeeld wilt u testen of het subelement price van het contextknooppunt kleiner is dan 5.

    Het dialoogvenster Meervoudig voorwaardelijk gebied
    Het dialoogvenster Meervoudig voorwaardelijk gebied

  3. Klik op OK.

    In het voorbeeld wordt de volgende code in uw XSLT-pagina ingevoegd.

    <xsl:choose> 
        <xsl:when test="price&lt;5"> 
            Content goes here 
        </xsl:when> 
        <xsl:otherwise> 
            Content goes here 
        </xsl:otherwise> 
    </xsl:choose>
  4. Om een andere voorwaarde in te voegen, plaatst u de invoegpositie in codeweergave tussen de paren <xsl:when>-tags of vlak voor de <xsl:otherwise>-tag en voegt daarna een voorwaardelijk gebied in (Invoegen > XSLT-objecten > Voorwaardelijk gebied).

    Nadat u de voorwaarde hebt opgegeven en op OK hebt geklikt, wordt een volgende <xsl:when>-tag ingevoegd in het <xsl:choose>-blok.

    Zie de secties <xsl:choose> in het paneel Referentie (Help > Referentie) voor meer informatie en voorbeelden betreffende het schrijven van voorwaardelijke expressies.

Eigenschappen voorwaardelijk gebied (If) instellen

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.

  1. Voer in het vak Test een nieuwe voorwaarde in en druk op Enter.

Eigenschappen voorwaarden (When) instellen

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.

  1. Voer in het vak Test een nieuwe voorwaarde in en druk op Enter.

XSL-commentaar invoegen

U kunt XSL-commentaartags aan een document toevoegen en een selectie in XSL-commentaartags omsluiten.

XSL-commentaartags aan een document toevoegen

  1. Voer een van de volgende handelingen uit:
    • 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.

Selectie in XSL-commentaartags omsluiten

  1. Schakel naar de codeweergave (Weergave > Code).
  2. Selecteer de code waarbij u een commentaar wilt maken.
  3. Klik in de werkbalk Commentaar toepassen en kies Toepassen <xsl:comment></xsl:comment> Commentaar.

Expressies voor XML-gegevens toevoegen met XPath Expression Builder

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.

XPath-expressie maken om een bepaald knooppunt aan te duiden

  1. Dubbelklik op de tijdelijke aanduiding voor XML-gegevens op de pagina om XPath Expression Builder te openen.
  2. Selecteer in het dialoogvenster XPath Expression Builder (dynamische tekst) een knooppunt in het XML-schema.

    De correcte XPath-expressie wordt in het vak Expressie geschreven om het knooppunt aan te duiden.

    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)
    Het dialoogvenster XPath Expression Builder (dynamische tekst)

    Deze selectie voegt de volgende code in op uw XSLT-pagina:

    <xsl:value-of select="price"/>
  3. (Optioneel) Selecteer een opmaakoptie in het pop-upmenu Opmaak.

    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
    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')"/>
  4. Klik op OK.
  5. Om de waarde van elk knooppunt in het XML-bestand weer te geven past u een herhalingsgebied toe op het element met de dynamische tekst (bijvoorbeeld een HTML-tabelrij of een alinea).

    Zie de sectie <xsl:value-of/> in het paneel Referentie voor meer informatie en voorbeelden desbetreffende het selecteren van knooppunten voor het retourneren van waarden.

Te herhalen knooppunt selecteren

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.

  1. Dubbelklik op de tijdelijke aanduiding voor XML-gegevens op de pagina om XPath Expression Builder te openen.
  2. Selecteer in het dialoogvenster XPath Expression Builder (herhalingsgebied) het item dat herhaald moet worden in het XML-schema.

    De correcte XPath-expressie wordt in het vak Expressie geschreven om het knooppunt aan te duiden.

    Opmerking:

    Herhalende items worden in het XML-schema aangeduid met een plusteken (+).

    In het volgende voorbeeld wilt u elk knooppunt item in het XML-bestand herhalen.

    Het dialoogvenster XPath Expression Builder (herhalingsgebied)
    Het dialoogvenster XPath Expression Builder (herhalingsgebied)

    Als u op OK klikt, wordt de volgende code op uw XSLT-pagina ingevoegd.

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

    Soms wilt u wellicht werken met een subset van de herhalende knooppunten–bijvoorbeeld als u alleen artikelen wilt met een kenmerk van een bepaalde waarde. In dat geval moet u een filter maken.

Te herhalen gegevens filteren

Gebruik een filter om herhalende knooppunten met bepaalde kenmerkwaarden aan te duiden.

  1. Selecteer in het XML-schema een knooppunt om te herhalen.
  2. Klik op de uitvouwknop van Filter bouwen.
  3. Klik op de plusknop (+) om een leeg filter te maken.
  4. Voer in de volgende velden de filtercriteria in.

    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.

    Operator

    Geeft de vergelijkingsoperator aan voor gebruik in de filterexpressie.

    Waarde

    Geeft de waarde aan die gecontroleerd moet worden in het knooppunt voor Filteren op. Voer de waarde in. Als dynamische parameters voor uw XSLT-pagina gedefinieerd zijn, kunt u een daarvan selecteren in het pop-upmenu.

  5. Klik nogmaals op de knop Plus (+) om een ander filter op te geven.

    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
    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 = &apos;true&apos;]"> Inhoud komt hier </xsl:for-each>

    <xsl:for-each select="provider/store/items/item[@available = &apos;true&apos;]"> 
          Content goes here 
    </xsl:for-each>

    Opmerking:

    Tekenreekswaarden als “true" moet u tussen aanhalingstekens plaatsen. Dreamweaver codeert de aanhalingstekens voor u (&apos;) 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
    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 &gt; 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 &gt; 5]"> 
        Content goes here 
    </xsl:for-each>

Dit werk is gelicentieerd onder de Creative Commons Naamsvermelding/Niet-commercieel/Gelijk delen 3.0 Unported-licentie  De voorwaarden van Creative Commons zijn niet van toepassing op Twitter™- en Facebook-berichten.

Juridische kennisgevingen   |   Online privacybeleid