Composants de template réutilisables avec les Snippets et Partials

Dernière mise à jour le 23 mars 2026

PDFMonkey vous offre deux moyens de réutiliser du code et d’éviter la duplication :

  • Les Snippets sont partagés entre les templates — définissez-les une fois sur la page Snippets et incluez-les dans n’importe quel template.
  • Les Partials sont locaux à un seul template — définissez un bloc réutilisable en ligne et incluez-le plusieurs fois dans le même template.

Les deux utilisent le tag include pour afficher le bloc réutilisable avec les variables que vous lui passez.

Snippets

Si vous avez besoin de partager du code entre plusieurs Templates, vous pouvez définir des snippets dans la page Snippets de votre compte PDFMonkey. Le nom que vous donnez à un Snippet est celui que vous utiliserez pour y faire référence plus tard dans vos Templates.

Définissons deux snippets :

{%- if userName -%}
  {{userName}}
{%- else -%}
  Quelqu’un
{%- endif -%}

{%- for item in list -%}
  <p>{{item}}</p>
{%- endfor -%}

Vous pouvez ensuite les charger et les inclure dans un Template :

{%- load_snippets 'user-name', 'items-list' -%}

<p>Bonjour {% include 'user-name', userName: "Jane Doe" %}</p>

{% include 'items-list', list: user.groceries %}
Vous devez charger les snippets avec load_snippets avant de pouvoir les inclure avec include. Listez tous les snippets nécessaires dans un seul appel load_snippets en haut de votre template.

Partials

Les partials fonctionnent comme les Snippets mais sont définis directement dans un Template. Vous n’avez pas besoin de les charger avant de les inclure :

{%- partial 'line-item' -%}
  <tr>
    <td>{{product.name}}</td>
    <td>{{product.unitPrice}}</td>
    <td>{{product.quantity}}</td>
    <td>{{product.totalPrice}}</td>
  </tr>
{%- endpartial -%}

{% for lineItem in lineItems %}
  {% include 'line-item', product: lineItem %}
{% endfor %}

Les partials sont idéaux lorsque vous devez répéter un bloc au sein d’un même template — comme une ligne de tableau, une carte, ou tout élément récurrent — sans avoir à créer un Snippet partagé.

Questions fréquentes

Comment réutiliser du code entre plusieurs templates PDFMonkey ?
Utilisez les Snippets. Définissez des blocs de code réutilisables dans la page Snippets de votre compte PDFMonkey, puis chargez-les dans n’importe quel template avec le tag load_snippets et incluez-les avec le tag include.
Quelle est la différence entre les Snippets et les Partials dans PDFMonkey ?
Les Snippets sont partagés entre les templates — définissez-les une fois et incluez-les dans n’importe quel template. Les Partials sont locaux à un seul template — définissez un bloc réutilisable en ligne et incluez-le plusieurs fois au sein du même template.
Comment passer des variables à un Snippet ou un Partial dans PDFMonkey ?
Passez les variables sous forme de paires clé-valeur dans le tag include. Par exemple : {% include 'user-name', userName: "Jane Doe" %}. Le Snippet ou le Partial peut ensuite utiliser ces variables dans son code Liquid.
Navigation