Choisissez Fichier > Nouveau.
Dernière mise à jour le
20 déc. 2021
Comment exécuter les transformations XSL côté serveur sous Dreamweaver. Création de pages XSLT et conversion de pages HTML en pages XSLT.
L’interface utilisateur a été simplifiée sous Dreamweaver et versions ultérieures. Par conséquent, il se peut que vous ne trouviez pas certaines options décrites dans cet article sous Dreamweaver et versions ultérieures. Pour plus d’informations, consultez cet article.
Processus pour effectuer des transformations XSL côté serveur
Vous pouvez effectuer des transformations XSL côté serveur.Renseignez-vous sur les transformations XSL côté serveur et côté client et sur l'utilisation de XML et XSL avec les pages web avant de créer des pages qui affichent des données XML.
Pour exécuter des transformations côté serveur, votre serveur doit être correctement configuré. Pour plus d’informations, contactez l’administrateur de votre serveur.
Le processus général pour effectuer des transformations XSL côté serveur est le suivant (chaque étape est décrite dans d'autres rubriques) :
1.Configurez un site Dreamweaver.
2.Choisissez une technologie de serveur et configurez un serveur d'application.
3.Testez le serveur d'application.
Par exemple, créez une page qui nécessite un traitement, et assurez-vous que le serveur d'application traite la page.
4.Créez un fragment ou une page XSLT, ou convertissez une page HTML en page XSLT.
Dans votre site Dreamweaver, créez un fragment XSLT ou une page XSLT complète.
Convertissez une page HTML existante en une page XSLT entière.
5.Attachez une source de données XML à la page.
6.Affichez les données XML en liant les données au fragment XSLT ou à la page XSLT complète.
7.Le cas échéant, ajoutez un objet XSLT Zone répétée au tableau ou à la ligne de tableau qui contient les espaces réservés de données XML.
8.Insérez des références.
Pour insérer une référence au fragment XSLT dans votre page dynamique, utilisez le comportement de serveur Transformation XSL.
Pour insérer une référence à la page XSLT complète dans la page dynamique, supprimez tout le code HTML d'une page dynamique, puis utilisez le comportement de serveur Transformation XSL.
9.Publiez la page et le fragment.
Publiez à la fois la page dynamique et le fragment XSLT (ou la page XSLT complète) sur votre serveur d'application. Si vous utilisez un fichier XML local, vous devrez également le publier.
10.Affichez la page dynamique dans un navigateur.
Lorsque vous le faites, le serveur d'application transforme les données XML, les insère dans la page dynamique et les affiche dans le navigateur.
Création d’une page XSLT
Vous pouvez créer des pages XSLT qui vous permettent d'afficher des données XML sur des pages web.Vous pouvez créer soit une page XSLT complète — une page XSLT qui contient une balise <body> et une balise <head> — soit un fragment XSLT.Lorsque vous créez un fragment XSLT, vous créez un fichier indépendant qui ne contient aucune balise body ou head — un simple morceau de code qui est inséré par la suite dans une page dynamique.
Si vous utilisez une page XSLT existante et devez lui associer une source de données XML.
Dans la catégorie Page vierge de la boîte de dialogue Nouveau document,
sélectionnez l'une des options suivantes dans la colonne Type de page :
Sélectionnez XSLT (page entière) pour créer une page XSLT complète.
Sélectionnez XSLT (Fragment) pour créer un fragment XSLT.
Cliquez sur Créer et effectuez l'une des opérations suivantes dans la boîte de dialogue Localiser la source XML :
- Choisissez Associer un fichier local, cliquez sur le bouton Parcourir, recherchez le fichier XML local sur votre ordinateur, puis cliquez sur OK.
- Choisissez Associer un fichier distant, indiquez l’adresse URL d’un fichier XML sur Internet (par exemple un fil RSS), puis cliquez sur OK.
Un clic sur le bouton Annuler entraîne la génération d’une nouvelle page XSLT à laquelle aucune source de données XML n’est associée.
Le schéma de votre source de données XML s’affiche dans le panneau Liaisons
Le tableau suivant décrit les différents éléments que le schéma est susceptible de contenir.
Elément |
Représente |
Détails |
|---|---|---|
<> |
Elément XML non répété obligatoire |
Elément qui apparaît une fois seulement au sein de son nœud parent |
<>+ |
Elément XML répété |
Elément qui apparaît une ou plusieurs fois au sein de son nœud parent |
<>+ |
Elément XML facultatif |
Elément qui apparaît zéro ou plusieurs fois au sein de son nœud parent |
Nœud d'élément en gras |
Elément contextuel en cours |
En règle générale, l'élément répété lorsque le point d'insertion se trouve au sein d'une région répétée |
@ |
Attribut XML |
|
Enregistrez la nouvelle page (Fichier > Enregistrer) avec
l'extension .xsl ou .xslt (.xsl est l'extension par défaut).
Conversion des pages HTML en pages XSLT
Vous pouvez également convertir des pages HTML existantes en pages XSLT. Par exemple, si vous disposez d'une page statique prédéfinie à laquelle vous souhaitez ajouter des données XML, vous pouvez convertir la page en page XSLT, au lieu de créer une page XSLT et de reconcevoir la page à partir de zéro.
Ouvrez la page HTML à convertir.
Sélectionnez Fichier > Convertir > XSLT
1.0.
Une copie de la page s’ouvre dans la fenêtre de document. La nouvelle page est une feuille de style XSL, enregistrée en .xsl.
Association de sources de données XML
Si vous commencez avec une page XSLT existante, ou si vous ne joignez pas une source de données XML lors de la création d'une nouvelle page XSLT avec Dreamweaver, vous devez joindre une source de données XML à l'aide du panneau Liaisons.
Dans le panneau Liaisons (Fenêtre > Liaisons),
cliquez sur le lien XML.
Pour ajouter une source de données XML, vous pouvez aussi cliquer sur le lien Source, dans le coin supérieur droit du panneau Liaisons.
Effectuez l’une des opérations suivantes :
Sélectionnez Joindre un fichier local, cliquez sur le bouton Parcourir, accédez à un fichier XML local sur votre ordinateur, puis cliquez sur OK.
Sélectionnez Joindre un fichier distant, puis saisissez l'URL d'un fichier XML sur Internet (par exemple, un fichier provenant d'un flux RSS).
Cliquez sur OK pour fermer la boîte de dialogue Localiser source XML.
Le panneau Liaisons est rempli avec le schéma de votre source de données XML.
Affichage des données XML dans des pages XSLT
Après avoir créé une page XSLT et joint une source de données XML, vous pouvez lier des données à la page. Pour ce faire, vous ajoutez un espace réservé de données XML à votre page, puis utilisez le Générateur d'expressions XPath ou l'Inspecteur de propriétés pour formater les données sélectionnées qui s'afficheront sur la page.
Ouvrez une page XSLT à laquelle est associée une source de données XML.
(Facultatif) Sélectionnez Insérer > Tableau pour ajouter un
tableau à la page. Un tableau permet d’organiser plus aisément les données XML.
Annotation
Dans la plupart des cas, vous utilisez l'objet XSLT Zone répétitive pour afficher des éléments XML répétitifs sur une page. Dans ce cas, vous pourriez vouloir créer un tableau à une ligne avec une ou plusieurs colonnes, ou un tableau à deux lignes si vous souhaitez inclure un en-tête de tableau.
Dans le panneau Liaisons, sélectionnez un élément XML et faites-le glisser à l'endroit de la page où vous souhaitez insérer des données.
Un espace réservé de données XML apparaît sur la page. L'espace réservé est surligné et entre accolades.Il utilise la syntaxe XPath (XML Path language) pour décrire la structure hiérarchique du schéma XML. Par exemple, si vous faites glisser l'élément enfant title sur la page, et que cet élément a les éléments parents rss, channel, et item, alors la syntaxe de l'espace réservé de contenu dynamique sera {rss/channel/item/title}.
Double-cliquez sur l'espace réservé de données XML sur la page pour ouvrir le Générateur d'expressions XPath. Le Générateur d'expressions XPath vous permet de formater des données sélectionnées, ou de sélectionner d'autres éléments du schéma XML.
(Facultatif) Appliquez des styles à vos données XML en sélectionnant
un espace réservé de données XML et en lui appliquant des styles comme tout autre
élément de contenu à l'aide de l'Inspecteur de propriétés ou du
panneau Styles CSS. Vous pouvez également utiliser les feuilles de style au moment de la conception pour appliquer des styles aux fragments XSLT.Chacune de ces méthodes a ses propres avantages et limites.
Prévisualisez votre travail dans un navigateur (Fichier > Aperçu dans le navigateur).
Lorsque vous utilisez la fonction Aperçu dans le navigateur, Dreamweaver effectue une transformation XSL en interne, sans faire appel à un serveur d’application.
Affichage des éléments répétés XML
L'objet XSLT Région répétée vous permet d'afficher des éléments répétitifs d'une source de données XML dans une page web. Par exemple, si vous affichez des titres d'Articles et des descriptions d'un fil d'actualités, et que ce fil d'actualités contient entre 10 et 20 Articles, chaque titre et description dans le fichier XML serait probablement un élément enfant d'un élément répétitif.
Toute zone en vue Création contenant un espace réservé de données XML peut être transformée en zone répétée.Cependant, les régions les plus courantes sont les tableaux, les lignes de tableau ou une série de lignes de tableau.
En mode Création, sélectionnez une zone qui contient un ou plusieurs espaces réservés de données XML.
La sélection peut être n'importe quoi, y compris un tableau, une ligne de tableau ou même un paragraphe de texte.
Pour sélectionner précisément une région sur une page, vous pouvez utiliser le sélecteur de balises dans le coin inférieur gauche de la fenêtre de document. Par exemple, si la région correspond à un tableau, cliquez dans ce tableau, puis cliquez sur la balise dans le sélecteur de balises.
Effectuez l’une des opérations suivantes :
Sélectionnez Insertion > Objets XSLT > Région répétée.
Dans la catégorie XSLT du panneau Insertion, cliquez sur le bouton Région répétée.
Dans le Générateur d'expressions XPath, sélectionnez l'élément répétitif, indiqué par un petit signe plus.
Cliquez sur OK.
Dans la fenêtre de document, un fin contour gris à onglets apparaît autour de la région répétée.Lorsque vous prévisualisez votre travail dans un navigateur (Fichier > Aperçu dans le navigateur), le contour gris disparaît et la sélection se développe pour afficher les éléments répétés spécifiés dans le fichier XML.
Lorsque vous ajoutez l'objet XSLT Région répétée à la page, l'espace réservé de données XML dans la fenêtre document est tronqué. C'est parce que Dreamweaver tronque le XPath pour l'espace réservé de données XML afin qu'il soit relatif au chemin d'accès de l'élément répétitif.
Définition des propriétés des régions répétées (XSL)
Dans l'inspecteur de propriétés, vous pouvez sélectionner un nœud XML différent pour créer la région répétée.
Dans la zone Sélection, saisissez un nouveau nœud, puis appuyez sur l'icône en forme d'éclair et sélectionnez le nœud dans l'arborescence de schéma XML qui apparaît.
Modification d’un objet XSLT Région répétée
Après avoir ajouté un objet XSLT Région répétée à une zone géographique, vous pouvez le modifier à l'aide de l'inspecteur de propriétés.
Sélectionnez l'objet en cliquant sur l'onglet gris qui entoure la région répétée.
Dans l'inspecteur de propriétés (Fenêtre > Propriétés), cliquez sur l'icône dynamique située à côté du champ de texte Sélection.
Dans le générateur d'expressions XPath, apportez vos modifications et cliquez sur OK.
Insérer des fragments XSLT dans des pages dynamiques
Après avoir créé un fragment XSLT, vous pouvez l'insérer dans une page web dynamique à l'aide du comportement Serveur de transformation XSL. Lorsque vous ajoutez le comportement de serveur à votre page et que vous affichez la page dans un navigateur, un serveur applicatif effectue une transformation qui affiche les données XML du fragment XSLT sélectionné.Dreamweaver prend en charge les transformations XSL pour les pages ColdFusion, ASP ou PHP.
La procédure d’insertion du contenu d’une page XSLT entière dans une page dynamique est identique. Avant d’utiliser le comportement de serveur Transformation XSL pour insérer la page XSLT entière, supprimez tout le code HTML de la page dynamique.
Ouvrez une page ColdFusion, ASP ou PHP.
En mode Création, placez le point d'insertion à l'emplacement
où vous souhaitez insérer le fragment XSLT.
Lors de l’insertion de fragments XSLT, vous devez toujours cliquer sur le bouton Afficher les modes Code et Création après avoir placé le point d’insertion sur la page, de façon à s’assurer que le point d’insertion est à l’emplacement voulu. S’il n’y est pas, cliquez de nouveau dans l’écran Code pour placer le point d’insertion à l’endroit voulu.
Dans le panneau Comportements de serveur (Fenêtre > Comportements
de serveur), cliquez sur le bouton Plus (+) et sélectionnez Transformation XSL.
Dans la boîte de dialogue Transformation XSL, cliquez sur le bouton Parcourir
et accédez à un fragment XSLT ou à une page XSLT complète.
Dreamweaver renseigne automatiquement le champ de texte suivant avec le chemin d'accès au fichier ou l'URL du fichier XML associé au fragment spécifié. Pour le modifier, cliquez sur le bouton Parcourir et accédez à un autre fichier.
(Facultatif) Cliquez sur le bouton Plus (+) pour ajouter un paramètre XSLT.
Cliquez sur OK pour insérer une référence au fragment XSLT dans
la page. Il n’est pas possible de modifier ce fragment. Vous pouvez double-cliquer sur le
fragment pour ouvrir le fichier source du fragment et le modifier.
Un dossier includes/MM_XSLTransform/ est également créé dans le dossier racine du site et contient un fichier de bibliothèque d'exécution. Le serveur d'applications utilise les fonctions définies dans ce fichier pour effectuer la transformation.
Chargez la page dynamique sur votre serveur (Site >
Placer) et cliquez sur Oui pour inclure les fichiers dépendants. Le fichier contenant
le fragment XSLT, le fichier XML contenant vos données et le fichier
de bibliothèque d'exécution généré doivent tous se trouver sur le serveur pour que votre page
s'affiche correctement. (Si vous avez sélectionné un fichier XML distant comme source de données,
ce fichier doit résider ailleurs sur Internet.)
Supprimer les fragments XSLT des pages dynamiques
Vous pouvez supprimer un fragment XSLT d'une page en supprimant le comportement de serveur de transformation XSL utilisé pour insérer le fragment.La suppression du comportement de serveur supprime uniquement le fragment XSLT : elle ne supprime pas les fichiers XML, XSLT ou de bibliothèque d'exécution associés.
Dans le panneau Comportements de serveur (Fenêtre >
Comportements de serveur), sélectionnez le comportement de serveur Transformation XSL
que vous souhaitez supprimer.
Cliquez sur le bouton Moins (-).
Vous devez toujours utiliser cette méthode pour supprimer un comportement de serveur. En effet, la suppression manuelle du code correspondant ne supprime que partiellement le comportement de serveur, même si celui-ci disparaît bien du panneau Comportements de serveur.
Modifier les comportements de serveur Transformation XSL
Après avoir ajouté un fragment XSLT à une page web dynamique, vous pouvez modifier le comportement de serveur Transformation XSL à tout moment.
Dans le panneau Comportements de serveur (Fenêtre > Comportements de serveur), double-cliquez sur le comportement de serveur de transformation XSL que vous souhaitez modifier.
Effectuez les modifications requises, puis cliquez sur OK.
Création d’un lien dynamique
Vous pouvez créer un lien dynamique sur votre page XSLT qui renvoie à une URL spécifique lorsque l'utilisateur clique sur un mot ou un groupe de mots spécifiés dans vos données XML. Pour obtenir des instructions complètes, consultez l'errata de Dreamweaver à l'adresse www.adobe.com/go/dw_documentation.
Application de styles aux fragments XSLT
Lorsque vous créez une page XSLT complète (c'est-à-dire une page XSLT qui contient les balises <body> et <head>), vous pouvez afficher les données XML sur la page, puis formater les données comme tout autre élément de contenu à l'aide de l'inspecteur Propriétés ou du panneau Styles CSS. Cependant, lorsque vous créez un fragment XSLT pour l'insérer dans une page dynamique (par exemple, un fragment à insérer dans une page ASP, PHP ou Cold Fusion), le rendu des styles dans le fragment et dans la page dynamique devient plus compliqué.Bien que vous travailliez sur un fragment XSLT séparément de la page dynamique, il est important de rappeler que le fragment est destiné à être utilisé dans la page dynamique, et que la sortie du fragment XSLT réside finalement quelque part dans les balises <body> de la page dynamique. Étant donné ce workflow, il est important de s'assurer de ne pas inclure d'éléments <head> (tels que des définitions de style ou des liens vers des feuilles de style externes) dans les fragments XSLT. Cela entraînerait le placement de ces éléments par le serveur d'applications dans le <body> de la page dynamique, générant ainsi un balisage non valide.
Par exemple, vous pouvez créer un fragment XSLT pour l'insérer dans une page dynamique et formater le fragment en utilisant la même feuille de style externe que la page dynamique. Si vous attachez la même feuille de style au fragment, la page HTML résultante contient un lien dupliqué vers la feuille de style (un dans la section <head> de la page dynamique, et un autre dans la section <body> de la page, où apparaît le contenu du fragment XSLT). Au lieu de cette approche, vous devriez utiliser les feuilles de style au moment de la conception pour référencer la feuille de style externe.
Lors du formatage du contenu des fragments XSLT, utilisez le workflow suivant :
Tout d’abord, attachez une feuille de style externe à la page dynamique. (Cette procédure reprend les meilleures pratiques d’application des styles au contenu d’une page web.)
Ensuite, attachez la même feuille de style externe au fragment XSLT en tant que feuille de style à la conception. Tel que leur nom l’indique, les feuilles de style à la conception fonctionnent uniquement en mode Création sous Dreamweaver.
Une fois les deux étapes précédentes terminées, vous pouvez créer de nouveaux styles dans votre fragment XSLT à l’aide de la feuille de style qui a été associée à votre page dynamique. Vous obtiendrez un code HTML mieux structuré (dans la mesure où la référence à la feuille de style n’est valide que sous Dreamweaver) et le fragment affichera toujours les styles requis en mode Création. De plus, tous vos styles sont appliqués au fragment et à la page dynamique lorsque vous affichez cette dernière en mode Création ou en affichez un aperçu dans un navigateur.
Si vous demandez un aperçu du fragment XSLT dans un navigateur, ce dernier n’affiche pas les styles. Par contre, vous devez afficher un aperçu de la page dynamique dans le navigateur afin de consulter le fragment XSLT dans le contexte de la page dynamique.
Utilisation des paramètres avec des transformations XSL
Vous pouvez définir des paramètres pour la transformation XSL lors de l'ajout du comportement de serveur Transformation XSL à une page web. Un paramètre contrôle la façon dont les données XML sont traitées et affichées. Par exemple, vous pouvez utiliser un paramètre pour identifier et lister un article spécifique d'un fil d'actualités. Lorsque la page se charge dans un navigateur, seul l'article que vous avez spécifié avec le paramètre apparaît.
Ajoutez un paramètre XSLT à une transformation XSL
Ouvrez la boîte de dialogue Transformation XSL.
Vous pouvez le faire en double-cliquant sur un comportement de serveur Transformation XSL dans le panneau Comportements de serveur (Fenêtre > Comportements de serveur), ou en ajoutant un nouveau comportement de serveur Transformation XSL.
Dans la boîte de dialogue Transformation XSL, cliquez sur le bouton Plus (+) à côté de Paramètres XSLT.
Dans la boîte de dialogue Ajouter des paramètres, entrez un nom pour le paramètre dans la zone Nom. Le nom ne peut contenir que des caractères alphanumériques. et il ne doit pas contenir d’espace.
Effectuez l’une des opérations suivantes :
Si vous voulez utiliser une valeur statique, entrez-la dans la zone Valeur.
Si vous voulez utiliser une valeur dynamique, cliquez sur l'icône dynamique à côté de la zone Valeur, complétez la boîte de dialogue Données dynamiques, et cliquez sur OK. Pour plus d'informations, cliquez sur le bouton Aide dans la boîte de dialogue Données dynamiques.
Dans la zone Valeur par défaut, entrez la valeur que vous voulez que le paramètre utilise si la page ne reçoit aucune valeur d'exécution, et cliquez sur OK.
Modification d’un paramètre XSLT
Ouvrez la boîte de dialogue Transformation XSL.
Vous pouvez le faire en double-cliquant sur un comportement de serveur Transformation XSL dans le panneau Comportements de serveur (Fenêtre > Comportements de serveur), ou en ajoutant un nouveau comportement de serveur Transformation XSL.
Sélectionnez un paramètre dans la liste des paramètres XSLT.
Cliquez sur le bouton Modifier.
Effectuez les modifications requises, puis cliquez sur OK.
Suppression d’un paramètre XSLT
Ouvrez la boîte de dialogue Transformation XSL.
Vous pouvez le faire en double-cliquant sur un comportement de serveur Transformation XSL dans le panneau Comportements de serveur (Fenêtre > Comportements de serveur), ou en ajoutant un nouveau comportement de serveur Transformation XSL.
Sélectionnez un paramètre dans la liste des paramètres XSLT.
Cliquez sur le bouton Moins (-).
Créez et modifiez des zones XSLT conditionnelles
Vous pouvez créer des zones conditionnelles simples ou multiples sur une page XSLT.Vous pouvez soit sélectionner un élément en vue Création et appliquer une zone conditionnelle à la sélection, soit insérer une zone conditionnelle où se trouve le point d'insertion dans le document.
Par exemple, si vous souhaitez afficher le mot « Non disponible » à côté du prix d'un article lorsque celui-ci n'est pas disponible, vous saisissez le texte « Non disponible » sur la page, vous le sélectionnez, puis vous appliquez une zone conditionnelle au texte sélectionné.Dreamweaver entoure la sélection avec les balises <xsl:if>, et affiche uniquement le mot « Indisponible » sur la page lorsque les données correspondent aux conditions de l'expression conditionnelle.
Application d’une région XSLT conditionnelle
Vous pouvez écrire une expression conditionnelle simple à insérer dans votre page XSLT.Si du contenu est sélectionné lorsque vous ouvrez la boîte de dialogue Zone conditionnelle, le contenu est encapsulé dans un bloc <xsl:if>.Si aucun contenu n'est sélectionné, le bloc <xsl:if> est ajouté au point d'insertion sur la page. Il est recommandé d'utiliser la boîte de dialogue pour commencer, puis de personnaliser l'expression dans l'affichage Code.
L'élément <xsl:if> est similaire à l'instruction if dans d'autres langages. L'élément offre un moyen de tester une condition et d'agir en fonction du résultat.L'élément <xsl:if> vous permet de tester une expression pour une seule valeur vraie ou fausse.
Sélectionnez Insertion > Objets XSLT > Zone conditionnelle ou cliquez sur l'icône Zone conditionnelle dans la catégorie XSLT du panneau Insertion.
Dans la boîte de dialogue Zone conditionnelle, saisissez l'expression conditionnelle
à utiliser pour la zone.
Dans l'exemple suivant, vous souhaitez tester pour voir si la valeur de l'attribut @available du nœud de contexte est true.
Cliquez sur OK.
Le code suivant est inséré dans votre page XSLT :
<xsl:if test="@available='true'">
Placez le contenu ici
</xsl:if>
Vous devez placer les valeurs de chaîne telles que true entre guillemets. Dreamweaver encode les guillemets pour vous (') afin qu'ils soient saisis comme XHTML valide.
En plus de tester les nœuds pour les valeurs, vous pouvez utiliser n'importe laquelle des fonctions XSLT prises en charge dans toute instruction conditionnelle. La condition est testée pour le nœud en cours de votre fichier XML. Dans l'exemple suivant, vous souhaitez tester le dernier nœud de l'ensemble de résultats :
Pour plus d'informations et d'exemples sur l'écriture d'expressions conditionnelles, consultez la section <xsl:if> dans le panneau Référence (Aide > Référence).
Appliquer plusieurs zones XSLT conditionnelles
Vous pouvez écrire une expression conditionnelle simple à insérer dans votre page XSLT. Si du contenu est sélectionné lorsque vous ouvrez la boîte de dialogue Zone conditionnelle, le contenu est encapsulé dans un bloc <xsl:choose>. Si vous ne sélectionnez pas de contenu, le bloc <xsl:choose> est ajouté au point d'insertion sur la page. Il est recommandé d'utiliser la boîte de dialogue pour commencer, puis de personnaliser l'expression dans l'affichage Code.
L'élément <xsl:choose> est similaire à l'instruction case dans d'autres langages. L'élément offre un moyen de tester une condition et de prendre une ligne de conduite basée sur le résultat. L'élément <xsl:choose> vous permet de tester plusieurs conditions.
Sélectionnez Insertion > Objets XSLT >
Zone conditionnelle multiple ou cliquez sur l'icône Zone conditionnelle multiple
dans la catégorie XLST du panneau Insertion.
Dans la boîte de dialogue Zone conditionnelle multiple, saisissez
la première condition.
Dans l'exemple suivant, vous voulez tester si le sous-élément price du nœud de contexte est inférieur à 5.
Cliquez sur OK.
Dans l'exemple, le code suivant est inséré dans votre page XSLT :
<xsl:choose>
<xsl:when test="price<5">
Placez le contenu ici
</xsl:when>
<xsl:otherwise>
Placez le contenu ici
</xsl:otherwise>
</xsl:choose>
Pour insérer une autre condition, placez le point d'insertion
en mode Code entre les paires de balises <xsl:when>
ou juste avant la balise <xsl:otherwise>, puis
insérez une zone conditionnelle (Insertion > Objets XSLT >
Zone conditionnelle).
Après avoir spécifié la condition et cliqué sur OK, une autre balise <xsl:when> est insérée dans le bloc <xsl:choose>.
Pour plus d'informations et d'exemples sur la rédaction d'expressions conditionnelles, consultez les sections <xsl:choose> dans le panneau Référence (Aide > Référence).
Définition des propriétés des régions conditionnelles (If)
L'objectif de l'inspecteur de propriétés Définir zone conditionnelle est de modifier la condition utilisée dans une zone conditionnelle de votre page XSL. La zone conditionnelle teste la condition et prend une mesure basée sur le résultat.
Dans la zone Test, saisissez une nouvelle condition, puis
appuyez sur Entrée.
Définition des propriétés conditionnelles (When)
L'objectif de l'inspecteur de propriétés « Définir une zone conditionnelle » est de modifier la condition utilisée dans une zone conditionnelle multiple de votre page XSL.La zone conditionnelle multiple teste la condition et prend une mesure basée sur le résultat.
Dans la zone Test, saisissez une nouvelle condition, puis
appuyez sur Entrée.
Insertion de commentaires XSL
Vous pouvez ajouter des balises de commentaire XSL à un document, ou vous pouvez encapsuler une sélection dans des balises de commentaire XSL.
Ajout de balises de commentaires XSL à un document
Effectuez l’une des opérations suivantes :
En mode Création, sélectionnez Insertion > Objets XSLT > Commentaire XSL, saisissez le contenu du commentaire (ou laissez la zone vide), et cliquez sur OK.
En mode Code, sélectionnez Insertion > Objets XSLT > Commentaire XSL.
Annotation
Vous pouvez également cliquer sur l'icône Commentaire XSL dans la catégorie XSLT du panneau Insertion.
Encapsuler une sélection dans des balises de commentaire XSL
Basculez vers le mode Code (Affichage >
Code).
Sélectionnez le code auquel vous souhaitez ajouter des commentaires.
Dans la barre d'outils Codage, cliquez sur le bouton Appliquer le commentaire
et sélectionnez Appliquer le commentaire <xsl:comment></xsl:comment>.
Utilisez le générateur d'expressions XPath pour ajouter des expressions pour les données XML
XPath (XML Path Language) est une syntaxe non XML pour cibler des parties d'un document XML.Il est principalement utilisé comme langage de requête pour les données XML, tout comme le langage SQL est utilisé pour interroger les bases de données. Pour plus d'informations sur XPath, consultez la spécification du langage XPath sur le site web du W3C à www.w3.org/TR/xpath.
Le générateur d'expressions XPath est une fonctionnalité de Dreamweaver qui vous permet de créer des expressions XPath simples pour identifier des nœuds de données spécifiques et pour les régions répétées.L'avantage d'utiliser cette méthode plutôt que de faire glisser les valeurs depuis l'arborescence du schéma XML est que vous pouvez formater la valeur qui s'affiche.Le contexte actuel est identifié en fonction de la position du point d'insertion dans le fichier XSL lorsque la boîte de dialogue Générateur d'expressions XPath s'ouvre. Le contexte en cours est affiché en gras dans l’arborescence du schéma XML. Lorsque vous effectuez des sélections dans cette boîte de dialogue, les instructions XPath correctes, relatives à votre contexte actuel, sont générées. Cela simplifie le processus d'écriture d'expressions XPath correctes pour les débutants et les utilisateurs avancés.
Cette fonction a été conçue pour vous aider à créer des expressions XPath simples pour identifier un nœud spécifique ou pour les régions répétées. Elle ne vous permet pas de modifier les expressions manuellement. Si vous devez créer des expressions complexes, utilisez le Créateur d’expressions XPath pour démarrer, puis personnalisez vos expressions en mode Code ou au moyen de l’inspecteur Propriétés.
Créer une expression XPath pour identifier un nœud spécifique
Double-cliquez sur l'espace réservé de données XML
sur la page pour ouvrir le générateur d'expressions XPath.
Dans la boîte de dialogue Générateur d'expressions XPath (texte dynamique), sélectionnez n'importe quel nœud dans l'arborescence du schéma XML.
L'expression XPath correcte est écrite dans la zone Expression pour identifier le nœud.
Annotation
Si vous sélectionnez un nœud différent dans l'arborescence du schéma XML, l'expression change pour refléter votre choix.
Dans l'exemple suivant, vous souhaitez afficher le sous-élément price du nœud item :
Cette sélection insérerait le code suivant dans votre page XSLT :
<xsl:value-of select="price"/>
(Facultatif) Sélectionnez une option de formatage dans le menu contextuel Format.
Le formatage d'une sélection est utile lorsque la Valeur de votre nœud renvoie un nombre. Dreamweaver fournit une liste prédéfinie de fonctions de formatage. Pour une liste complète des fonctions de formatage disponibles et des exemples, consultez le panneau Référence.
Dans l'exemple suivant, vous souhaitez formater le sous-élément price au format monétaire avec deux décimales :
Ces options inséreraient le code suivant dans votre page XSLT :<xsl:value-of select="format-number(provider/store/items/item/price,'$#.00')"/>
Cliquez sur OK.
Pour afficher la valeur de chaque nœud dans le fichier XML, appliquez une zone répétée à l'élément contenant le texte dynamique (par exemple, une ligne de tableau HTML ou un paragraphe).
Pour plus d'informations et d'exemples sur la sélection de nœuds pour renvoyer une Valeur, consultez la section <xsl:value-of/> dans le panneau Référence.
Sélection d’un nœud à répéter
Vous pouvez sélectionner un nœud à répéter et, le cas échéant, filtrer les résultats.Dans la boîte de dialogue Générateur d'expressions XPath, votre contenu sélectionné sera encapsulé dans un bloc <xsl:for-each>. Si vous n'avez pas sélectionné de contenu, le bloc <xsl:for-each> sera saisi au point d'insertion de votre Curseur.
Double-cliquez sur l'espace réservé de données XML de la page pour ouvrir le Générateur d'expressions XPath.
Dans la boîte de dialogue Générateur d'expressions XPath (Zone répétitive), sélectionnez l'élément à répéter dans l'arborescence de Schéma XML.
L'expression XPath correcte est écrite dans la zone Expression pour identifier le nœud.
Annotation
Les éléments répétitifs sont identifiés par un symbole plus (+) dans l'arborescence du schéma XML.
Dans l'exemple suivant, vous souhaitez répéter chaque nœud item dans le fichier XML.
Lorsque vous cliquez sur OK, le code suivant est inséré dans votre page XSLT :
<xsl:for-each select="provider/store/items/item">
Placez le contenu ici
</xsl:for-each>
Dans certains cas, vous souhaiterez peut-être travailler avec un sous-ensemble des nœuds répétitifs — par exemple, vous pourriez vouloir uniquement les éléments dont un attribut a une Valeur spécifique. Dans ce cas, vous devez créer un filtre.
Filtrage des données à répéter
Utilisez un filtre pour identifier les nœuds répétitifs qui ont des valeurs d'attribut spécifiques.
Dans l’arborescence du schéma XML, sélectionnez un nœud à répéter.
Cliquez sur le bouton d’extension Créer un filtre.
Cliquez sur le bouton Plus (+) pour créer un filtre vide.
Tapez les critères de filtre dans les champs suivants :
Filtrer par
Spécifie le nœud répétitif qui contient les données que vous souhaitez filtrer. Le menu contextuel fournit une liste de nœuds ancêtres relatifs au nœud que vous avez sélectionné dans l'arborescence de Schéma XML.
Où
Spécifie l'attribut ou le sous-élément du nœud Filtrer par qui sera utilisé pour limiter les résultats. Vous pouvez sélectionner un attribut ou un sous-élément dans le menu contextuel, ou vous pouvez saisir votre propre expression XPath dans ce champ pour identifier les enfants qui existent plus en profondeur dans l'arborescence de schéma.
Opérateur
Spécifie l'opérateur de comparaison à utiliser dans l'expression de filtre.
Valeur
Spécifie la valeur à rechercher dans le nœud Filtrer par. Indiquez une valeur. Si des paramètres dynamiques sont définis pour votre page XSLT, vous pouvez en sélectionner un dans le menu contextuel.
Pour spécifier un autre filtre, cliquez à nouveau sur le bouton
Plus (+).
Au fur et à mesure que vous saisissez des valeurs ou effectuez des sélections dans les menus contextuels, l'expression XPath dans la zone Expression change.
Dans l'exemple suivant, vous souhaitez restreindre le jeu de résultats aux nœuds item dont la Valeur de l'attribut @available est vrai.
![](https://helpx-prod.scene7.com/is/image/HelpxProd/xm_xpath-repeatwithfilter?$png$&jpegSize=100&wid=413 "Résultat restreint aux nœuds d’éléments pour lesquels la valeur de l’attribut @disponible est égale à "vrai"")
Lorsque vous cliquez sur OK, le code suivant est inséré dans votre page XSLT :<xsl:for-each select="provider/store/items/item[@available = 'true']"> Le contenu va ici </xsl:for-each>
Vous devez placer les valeurs de chaîne telles que true entre guillemets. Dreamweaver encode les guillemets pour vous (') afin qu'ils soient saisis comme XHTML valide.
Vous pouvez créer des filtres plus complexes qui vous permettent de spécifier des nœuds parents dans le cadre de vos critères de filtre.Dans l'exemple suivant, vous souhaitez limiter le jeu de résultats aux nœuds item dont l'attribut @id de la boutique en ligne est égal à 1 et le nœud price de l'item est supérieur à 5.
Lorsque vous cliquez sur OK, le code suivant est inséré dans la page XSLT :<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Content goes here </xsl:for-each>
Pour plus d'informations et d'exemples de zones répétitives, consultez la section <xsl:for-each> dans le panneau Référence.
Articles connexes
- Utilisation de sites Dreamweaver
- Choix d’un serveur d’application
- Utilisation des langages XML et XSL dans des pages web
- Transformations XSL côté client
- Transformations XSL côté serveur
- Aperçu des données XML
- Présentation de contenus dans des tableaux
- Données XML et éléments répétés
- Utilisation de feuilles de style à la conception
Créez de magnifiques sites web dans Dreamweaver
Concevez, codez et gérez des sites web dynamiques dans un puissant outil tout-en-un.
