PDF (adobe.com)

Création et modification des régions XSLT conditionnelles



Vous pouvez créer des régions conditionnelles simples ou multiples sur une page XSLT. Vous pouvez soit sélectionner un élément en mode Création, puis appliquer une région conditionnelle à la sélection, soit insérer une région conditionnelle à l'emplacement du point d'insertion dans le document.

Supposons que vous souhaitiez afficher l'expression « Non disponible » en regard du prix d'un article lorsque celui-ci est en rupture de stock. Pour ce faire, vous tapez l'expression « Non disponible » sur la page, la sélectionnez et lui appliquez une région conditionnelle. Dreamweaver entoure l'expression des balises <xsl:if> et affiche uniquement le mot « Non disponible » sur la page lorsque les données répondent aux conditions définies par l'expression conditionnelle.

Application d'une région XSLT conditionnelle

Vous pouvez rédiger une expression conditionnelle simple à insérer dans votre page XSLT. Tout contenu sélectionné à l'ouverture de la boîte de dialogue Région conditionnelle est entouré d'un bloc <xsl:if>. Si aucun contenu n'est sélectionné, le bloc <xsl:if> est entré au point d'insertion. Il est judicieux d'utiliser cette boîte de dialogue pour démarrer, puis de personnaliser l'expression en vue Code.

L'élément <xsl:if> est similaire à l'instruction if d'autres langages. Il a pour fonction de tester une condition et de déclencher une action en fonction du résultat. L'élément <xsl:if> vous permet de tester si une expression est vraie ou fausse.

  1. Choisissez Insertion > Objets XSLT > Région conditionnelle, ou cliquez sur l'icône Région conditionnelle de la catégorie XSLT du panneau Insertion.
  2. Dans la boîte de dialogue Région conditionnelle, entrez l'expression conditionnelle à utiliser pour la région.

    L'exemple suivant vérifie si la valeur de l'attribut @available du nœud contextuel correspond à true (vrai).

    Afficher le graphique à sa taille d'origine

  3. Cliquez sur OK.

    Le code suivant est inséré dans votre page XSLT :

    <xsl:if test="@available=&apos;true&apos;"> 
    Content goes here 
</xsl:if>
    Remarque : Vous devez placer les valeurs de chaîne telles que true entre guillemets. Dreamweaver code les guillemets (') à votre intention, afin qu'elles apparaissent dans un format XHTML valide.

    Outre tester des noeuds pour des valeurs, vous pouvez utiliser toute fonction XSLT prise en charge dans votre instruction conditionnelle. La condition est testée pour le noeud en cours de votre fichier XML. L'exemple suivant teste le dernier noeud des résultats :


    Pour plus d'informations et des exemples concernant l'écriture d'expressions conditionnelles, consultez la section <xsl:if> du panneau Références (Aide > Référence).

Application de régions XSLT conditionnelles multiples

Vous pouvez rédiger une expression conditionnelle simple à insérer dans votre page XSLT. Tout contenu sélectionné à l'ouverture de la boîte de dialogue Région conditionnelle est entouré d'un bloc <xsl:choose>. Si vous ne sélectionnez pas de contenu, le bloc <xsl:choose> est entré au point d'insertion. Il est judicieux d'utiliser cette boîte de dialogue pour démarrer, puis de personnaliser l'expression en vue Code.

L'élément <xsl:choose> est similaire à l'instruction case d'autres langages. Il a pour fonction de tester une condition et de déclencher une action en fonction du résultat. L'élément <xsl:choose> vous permet de tester plusieurs conditions.

  1. Choisissez Insertion > Objets XSLT > Région conditionnelle multiple, ou cliquez sur l'icône Région conditionnelle multiple de la catégorie XSLT du panneau Insertion.
  2. Entrez la première condition dans la boîte de dialogue Région conditionnelle multiple.

    L'exemple suivant vérifie si la valeur du sous-élément price du nœud contextuel est inférieure à 5.


  3. Cliquez sur OK.

    Le code suivant est inséré dans votre page XSLT :

    <xsl:choose> 
    <xsl:when test="price&lt;5"> 
        Content goes here 
    </xsl:when> 
    <xsl:otherwise> 
        Content goes here 
    </xsl:otherwise> 
</xsl:choose>
  4. 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 région conditionnelle (Insertion > Objets XSLT > Région conditionnelle).

    Une fois que vous avez 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 des exemples concernant l'écriture d'expressions conditionnelles, consultez les sections <xsl:choose> du panneau Références (Aide > Référence).

Définition des propriétés des régions conditionnelles (If)

L'inspecteur de définition des propriétés des régions conditionnelles permet de modifier la condition utilisée dans une région conditionnelle dans votre page XSL. La région conditionnelle teste la condition et déclenche une action en fonction du résultat.

 Dans la zone Test, tapez une nouvelle condition et appuyez sur Entrée.

Définition des propriétés conditionnelles (When)

L'inspecteur de définition des propriétés des régions conditionnelles permet de modifier la condition utilisée dans une région conditionnelle multiple dans votre page XSL. La région conditionnelle multiple teste la condition et déclenche une action en fonction du résultat.

 Dans la zone Test, tapez une nouvelle condition et appuyez sur Entrée.