Composants d'un template PDF
Les composants sont les éléments que vous placez dans les sections pour construire votre document. Chacun a son rôle : afficher du texte, montrer des images, présenter des tableaux, générer des codes-barres ou des QR codes.
Ajouter un composant
Section intitulée « Ajouter un composant »- Cliquez sur le type de composant dans la palette du panneau de gauche.
- Cliquez sur le canevas, dans la section voulue : le composant s’y place.
- Glissez-le pour le positionner, ou saisissez ses coordonnées exactes dans le panneau de droite.
Pour dupliquer un composant, survolez-le dans le panneau des calques (Layers) et cliquez sur l’icône de copie.
Le texte est le composant le plus courant : titres, libellés, paragraphes, adresses, tout contenu écrit.
Une fois l’élément placé, cliquez dessus pour modifier son contenu directement sur le canevas. La barre d’outils du haut change la police, la taille, la graisse, la couleur et l’alignement.
Les éléments texte acceptent les variables dynamiques avec la syntaxe {{variable_name}}. Par exemple :
Bonjour {{customer_name}},
Votre commande n° {{order_number}} est confirmée.À la génération du PDF, les variables sont remplacées par les valeurs de vos données.
Texte fixe et variables se mélangent librement dans un même élément texte. Les expressions calculent aussi des valeurs, comme {{items.qty * items.unit_price}}.
Les images servent aux logos, photos de produits, signatures et à tout contenu visuel.
Deux façons d’ajouter une image :
- Envoyez un fichier depuis votre ordinateur (Upload Image) ;
- Collez l’URL d’une image externe.
Une image garde ses proportions quand vous la redimensionnez par une poignée d’angle.
Images dynamiques : une variable dans la source de l’image affiche une image différente dans chaque PDF. Saisissez {{product_image}} dans le champ Source URL or Variable du panneau de droite, puis envoyez l’URL de l’image dans les données de l’API.
Les tableaux présentent des données structurées en lignes et en colonnes : lignes d’une facture, listes de produits, plannings, etc.
Un nouveau tableau commence avec une ligne d’en-tête et une ligne de données. Ajoutez ou supprimez des colonnes et des lignes selon vos besoins.
Son atout principal : la répétition automatique des lignes. Avec des variables de tableau comme {{items.description}} ou {{items.qty}} dans une ligne de données, le tableau génère une ligne par élément de vos données. Inutile de fixer le nombre de lignes à l’avance : le tableau s’allonge avec vos données.
Un tableau peut aussi se poursuivre sur plusieurs pages. Si vos données comptent plus de lignes qu’une page ne peut en contenir, le tableau se coupe automatiquement. Pour que cela fonctionne correctement, le tableau doit être le seul élément de sa section.
Le guide des tableaux détaille leur mise en forme et leur configuration.
Code-barres
Section intitulée « Code-barres »Un code-barres transforme un texte ou un nombre en code lisible par un scanner : numéros de suivi, références produit, tout identifiant destiné à une machine.
Saisissez la valeur du code-barres dans le champ Value du panneau de droite : une valeur fixe ou une variable comme {{tracking_number}}.
Formats pris en charge : Code 128, Code 39, EAN-13, EAN-8 et ITF-14. La couleur des barres et la taille se règlent dans le panneau de droite.
Un QR code encode un texte, une URL ou toute autre donnée dans un carré lisible par un scanner : liens de paiement, adresses de sites, pages de suivi de commande.
Comme pour les codes-barres, saisissez la valeur dans le champ Content : une valeur fixe ou une variable comme {{payment_url}}. La couleur du premier plan, la couleur du fond et le niveau de correction d’erreur se règlent aussi.
La correction d’erreur détermine la part du QR code qui peut être abîmée tout en restant lisible. Un niveau élevé rend le code plus robuste, mais aussi plus dense. Le niveau par défaut est Medium (15 %).
Le guide Codes-barres et QR codes donne plus de détails.
Les formes sont des éléments visuels simples (rectangles, cercles ou lignes) qui servent de séparateurs, de fonds ou d’accents décoratifs. Réglez leur couleur de remplissage, la couleur et l’épaisseur de leur bordure et leur opacité dans le panneau de droite.
Travailler avec les composants
Section intitulée « Travailler avec les composants »Sélectionner et déplacer
Section intitulée « Sélectionner et déplacer »Cliquez sur un composant du canevas pour le sélectionner. Un composant sélectionné affiche des poignées de redimensionnement aux angles et sur les bords. Glissez-le pour le déplacer, ou saisissez ses coordonnées X et Y exactes dans le panneau de droite.
Redimensionner
Section intitulée « Redimensionner »Tirez une poignée d’angle pour redimensionner en gardant les proportions, ou une poignée de bord pour étirer dans une seule direction. Vous pouvez aussi saisir la largeur et la hauteur exactes dans le panneau de droite.
Renommer
Section intitulée « Renommer »Double-cliquez sur le nom d’un composant dans le panneau des calques pour le renommer. Des noms clairs comme « Logo », « Adresse client » ou « Tableau des lignes » rendent le template plus simple à maintenir.
Supprimer
Section intitulée « Supprimer »Survolez le composant dans le panneau des calques et cliquez sur l’icône de corbeille, ou sélectionnez-le et appuyez sur la touche Suppr de votre clavier.
Étapes suivantes
Section intitulée « Étapes suivantes »- Tableaux : le guide détaillé pour construire et mettre en forme vos tableaux
- Mise en forme : personnalisez l’apparence de chaque composant
- Expressions : des valeurs calculées dans vos composants