Définition des options de la boîte de dialogue Créateur d'expression XPATH (Texte dynamique)

Cette boîte de dialogue vous permet de sélectionner dans vos données XML une valeur à afficher sur votre page. Dreamweaver insère une balise <xsl:value-of/> au point d'insertion. Cette méthode présente un avantage sur le glissement-déplacement de valeurs à partir de l'arborescence du schéma XML car elle vous permet de mettre en forme la valeur qui est affichée.

Un des avantages de XPath Expression Builder, c'est qu'il identifie le contexte en cours en fonction de votre position dans le fichier XSL à l'ouverture de la boîte de dialogue. Le contexte en cours est affiché en gras dans l'arborescence du schéma XML. Au fur et à mesure que vous effectuez des sélections dans la boîte de dialogue, XPath Expression Builder génère les instructions XPath correctes relatives à votre contexte en cours. Cette fonction simplifie le processus d'écriture d'expressions XPath correctes, tant pour les novices que les utilisateurs expérimentés.

XPath (XML Path Language) est une syntaxe non XML destinée à traiter des parties d'un document XML. Elle est essentiellement utilisée comme langage de requêtes pour des données XML, tout comme le langage SQL est utilisé pour des requêtes de bases de données. Pour plus d'informations sur XPath, consultez les spécifications du langage XPath sur le site Web du W3C, à l'adresse www.w3.org/TR/xpath.

Il est important de noter que cette boîte de dialogue est conçue pour vous aider à créer des expressions XPath simples en vue d'identifier un nœud spécifique. Elle ne vous permet pas de modifier les expressions manuellement. Si vous devez créer des expressions complexes, utilisez cette boîte de dialogue pour démarrer, puis personnalisez vos expressions en mode Code ou au moyen de l'inspecteur Propriétés.

Pour sélectionner une valeur à afficher sur votre page :

  1. Dans la boîte de dialogue Créateur d'expression XPATH (Texte dynamique), sélectionnez un nœud dans l'arborescence du schéma XML.

    Dreamweaver inscrit l'expression XPath appropriée dans la zone de texte Expression pour identifier le nœud.

    Dans l'exemple suivant, vous souhaitez afficher le sous-élément price du nœud item :



    Une telle sélection insère le code suivant dans votre page XSLT :

    <xsl:value-of select="price"/>
    
  2. Le cas échéant, sélectionnez une option de mise en forme dans le menu déroulant Format.

    La mise en forme d'une sélection est utile lorsque la valeur du nœud renvoie un nombre. Dreamweaver propose une liste prédéfinie de fonctions de mise en forme. Vous trouverez la liste complète de ces fonctions, ainsi que des exemples, dans le panneau Références.

    Dans l'exemple suivant, vous souhaitez afficher le sous-élément price sous la forme d'une devise à deux décimales :



    Ces options insèrent le code suivant dans votre page XSLT :

    <xsl:value-of select="format-number(provider/store/items/item/
    price,'$#.00')"/>
    
  3. Cliquez sur OK.
  4. Pour afficher la valeur de chaque nœud dans le fichier XML, appliquez une région répétée à l'élément contenant le texte dynamique (une ligne d'un tableau HTML ou un paragraphe, par exemple).

    Pour plus d'informations, voir Affichage d'éléments répétés XML.

Pour plus d'informations et des exemples concernant la sélection de nœuds pour renvoyer une valeur, consultez la section <xsl:value-of/> du panneau Références.