Composants de template réutilisables avec les Snippets et Partials

Dernière mise à jour le 13 mai 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