Vous verrez à la fois Props et Parameters lors de la modification d’un modèle. Les deux fournissent des valeurs au contenu, mais ils servent des objectifs différents : l’un stocke les valeurs qui appartiennent au modèle, tandis que l’autre reçoit des données pour chaque document.
Les garder séparés vous permet de modifier la conception en un seul endroit et de la réutiliser avec différentes données, sans rouvrir l’éditeur à chaque exécution.
1. Choisissez où appartient une valeur
Utilisez Props pour les valeurs enregistrées avec le modèle, telles que les titres, les étiquettes, les couleurs et les logos. Utilisez Parameters pour les données fournies par exécution, telles qu’un destinataire, un numéro de référence ou une liste d’éléments.
| Valeur | À sa place |
|---|---|
| Une étiquette « Destinataire » | Un accessoire sur la section l’affichant. |
| Le nom du destinataire | Un paramètre. |
| Une couleur ou un logo partagé | Un accessoire Global. |
| Une liste d’éléments | Un paramètre de tableau. |
| Une étiquette avec versions anglais/vietnamien | Un accessoire avec des valeurs spécifiques aux variantes. |
2. Props appartient à la pièce que vous éditez
Sélectionnez une section, un en-tête ou un pied de page dans Structure, puis ouvrez Props. Sélectionnez Ajouter un accessoire pour ajouter une valeur. Les types disponibles incluent Texte, Nombre, Booléen, Tableau, Objet, Couleur et Actif.
Dans le HTML de cette partie, lisez l’accessoire avec {{ props.heading }}. Pour un accessoire Global partagé, utilisez {{ global.props.propName }}.
Différentes sections peuvent avoir props avec le même nom. Vérifiez le nom de la section au-dessus de la liste Props pour voir quelle partie vous modifiez.
3. Parameters fournit des données pour chaque exécution
Ouvrez Parameters → Schema pour déclarer les noms de champs, les types et les valeurs par défaut. Utilisez {{ params.recipient }} dans HTML pour lire le champ recipient.
Inspectez l’objet de données dans Payload, puis utilisez cette structure lors de la saisie des données dans Run. La fourniture d’une nouvelle valeur modifie les données de l’exécution, et non le props enregistré dans le modèle.
Voir Déclarer les données d’entrée pour ajouter des champs à un modèle.
{ "recipient": "Tembuilder" }4. Combinez-les dans HTML
Par exemple, heading stocke un en-tête de section comme accessoire, tandis que recipient reçoit le nom du lecteur comme paramètre :
<h1>{{ props.heading }}</h1>
<p>{{ params.recipient }}</p>Modifiez heading dans Props pour modifier l’en-tête du modèle. Fournissez un autre recipient pour réutiliser le design pour une autre personne.
Pour plusieurs jeux d’étiquettes ou de couleurs dans un seul modèle, voir Variantes de modèle.
<h1>{{ props.heading }}</h1><p>{{ params.recipient }}</p>Tembuilder
Consultez la référence de syntaxe Handlebars pour les conditions, la portée, les échappements et les exemples avancés.