Répéteurs dans les pages

Le composant Répéteur répète le contenu au sein de l'Espace réservé du Répéteur une fois placé dans le contenu. Un Répéteur peut être utilisé pour afficher les éléments d'une lettre d'informations, de promotions, d'articles d'actualité. Les éléments du Répéteur sont complétés automatiquement à l'aide des éléments d'une source de données ou manuellement par le créateur du message.

La mise en page des éléments dans le Répéteur peut être la même pour chacun d'eux ou différente. Il existe plusieurs moyens de définir la mise en page d'un élément dans un Répéteur:

  • Alternance— Vous pouvez créer deux mises en page qui seront appliquées en alternance aux éléments. Le premier élément utilise la première mise en page, le deuxième élément la deuxième mise en page, le troisième élément la première mise en page et ainsi de suite.
  • Selon le contenu— Une mise en page différente est appliquée selon la valeur d'un champ de l'élément. S'il s'agit d'un champ booléen, deux mises en page sont disponibles, une pour vrai et une pour faux. S'il s'agit d'un champ texte ou numérique, vous pouvez créer autant de mises en page que nécessaire, une pour chaque valeur possible.

 

Ajoutez le composant Répéteur à la page.

1. Ajoutez le Répéteur à la page par glisser/déposer. Le Répéteur contient les sections En-tête, Mise en page, Pied de page et Vide.

2. Pour accéder à la fenêtre des propriétés du Répéteur, cliquez sur le Répéteur dans la liste des composants disponibles sur la droite, sur la balise du Répéteur dans le code source ou sur le composant Répéteur en mode WYSIWYG.

Le Répéteur comprend les sections suivantes:

  • En-tête— Cette section s'affiche une fois, au-dessus de tous les éléments.
  • Mise en page— Cette section contient les éléments réels qui seront sélectionnés automatiquement. Par défaut, il n'y a qu'une seule section mise en page. L'option Afficher plusieurs mises en page permet toutefois à l'utilisateur de définir et d'utiliser différentes mises en page pour les éléments.
  • Pied de page— Cette section s'affiche une fois, en dessous de tous les éléments.
  • Répéteur vide— Définit le contenu à afficher lorsqu'aucun élément n'est trouvé pour un contact spécifique. Lorsque vous utilisez un Filtre de correspondance, il se peut qu'aucun élément ne corresponde aux critères du filtre. Dans ce cas, c'est le contenu par défaut qui s'affiche.

Remarque: Lors de l'ajout d'un répéteur à une page, l'en-tête, le pied de page et la section RepaterEmpty sont par défaut invisibles. Vous pouvez modifier cela directement dans le code source.

 

Configurer le Répéteur

La première étape consiste à définir la source de contenu pour le Répéteur.

1. Cliquez sur le composant Répéteur dans la liste des composants disponibles. La fenêtre des propriétés du Répéteur s'affiche à droite:

2. Sélectionnez une sélection de données dans la liste déroulante, en guise de source de contenu du Répéteur. Si la sélection de données n'existe pas encore, cliquez sur Créer une nouvelle sélection de données pour accéder directement à la fenêtre des propriétés du contenu et en définir une. (Pour obtenir de plus amples informations à ce sujet, cliquezici)

Remarque: Seules les sélections de données définies dans les propriétés de la page sont répertoriées. Si la sélection de données dont vous avez besoin n'a pas encore été créée, cliquez ici pour en créer une nouvelle.

3. Définissez le nombre de Colonnes à afficher sur une ligne.Ceci définit le nombre d'éléments pouvant être affichés horizontalement l'un à côté de l'autre. Un maximum de 4 colonnes (et donc de 4 éléments sur une ligne) est autorisé. Si vous modifiez le nombre de colonnes, le Répéteur s'adapte de manière dynamique dans la conception.

Remarque: en mode Source, le nombre de colonnes du Répéteur peut être défini sur Absence de balisage HTML. Par conséquent, aucune balise HTML n'est ajoutée au code lors du rendu.

4. Définissez les propriétés de Mise en page pour ce Répéteur. Par défaut, il n'y a qu'une seule section mise en page.

5. Si vous souhaitez utiliser plusieurs mises en page dans le Répéteur, cliquez sur Afficher plusieurs mises en page et choisissez l'une des options dans la liste déroulante:

  • Alternance— Cette option permet de configurer deux sections de mise en page dans le Répéteur, avec le libellé Mise en page_1 et Mise en page_2.
    Ces mises en page sont ensuite appliquées en alternance aux éléments. En d'autres termes, le premier élément utilise la première mise en page, le deuxième élément la deuxième mise en page, le troisième élément à nouveau la première mise en page et ainsi de suite.
  • Selon le contenu— La mise en page appliquée à un élément dépend de la valeur d'un champ dans les propriétés de l'élément.
    Pour un champ booléen, si Vrai (signifiant que l'option est cochée), une mise en page s'affiche, si Faux, l'autre mise en page s'affiche.
    Pour les autres types de champ, vous pouvez entrer les valeurs possibles du champ. Pour chacune de ces valeurs, une section de mise en page différente est créée dans le Répéteur. Si aucune mise en page n'a été définie pour une valeur spécifique, la mise en page 'Autre' est appliquée. Cette section de mise en page « Autre » est automatiquement créée dans le répéteur et doit également être configurée.

Une fois l'option Selon le contenu sélectionnée à partir du menu déroulant, un champ supplémentaire Selon le contenu s'affiche. Il permet de sélectionner un champ à partir de la sélection de données qui sera utilisée pour déterminer la mise en page appliquée à l'élément.

Exemple: Dans l'exemple ci-dessus, nous utilisons le champ de texte Price_Discounted. Dans le champ Valeurs, ajoutez les différentes valeurs possibles pour lesquelles il faut créer une mise en page différente. Pour chaque valeur ajoutée, une section de mise en page est ajoutée. Elle contient le nom du champ et de la valeur actuelle utilisée.

Remarque: les valeurs des champs ne sont pas sensibles à la casse.