Syntaxe des champs
Les balises {champ}, {%image}, {#condition} expliquées.
Ce guide détaille la syntaxe à utiliser dans vos modèles Word pour insérer des champs dynamiques.
Champs texte
La syntaxe de base utilise des accolades simples autour du nom du champ.
{nom_du_champ}
Règles de nommage
- Utilisez des lettres minuscules, chiffres et des underscores
- Pas d'espaces, pas d'accents, pas de caractères spéciaux
- Le nom doit être explicite :
{nom_client}plutôt que{nc}
Exemples
| Dans le modèle | Résultat |
|---|---|
{nom_client} | Jean Dupont |
{date_contrat} | 15/02/2026 |
{montant_ht} | 1 500,00 |
{email} | jean@entreprise.fr |
Astuce
Vous pouvez placer les champs n'importe où dans votre document : dans le texte, dans un tableau, dans un en-tête ou un pied de page.
Champs image
Pour insérer une image dynamique (logo, signature, photo...), utilisez le préfixe % :
{%nom_du_champ}
Comment ça fonctionne
- Dans votre modèle Word, insérez une image placeholder (une image temporaire)
- Remplacez le texte alternatif de l'image par
{%nom_du_champ} - Lors de la génération, l'image placeholder sera remplacée par l'image fournie
Exemples
| Dans le modèle | Usage |
|---|---|
{%logo} | Logo de l'entreprise |
{%signature} | Signature manuscrite |
{%photo_profil} | Photo d'identité |
Important
L'image placeholder dans votre modèle définit la taille et la position de l'image finale. Choisissez une image placeholder aux bonnes dimensions.
Modifier le texte alternatif dans Word
- Faites un clic droit sur l'image dans Word
- Sélectionnez « Modifier le texte de remplacement » (ou « Alt Text »)
- Dans le champ de texte, tapez
{%nom_du_champ} - Enregistrez votre document
Sections conditionnelles
Les sections conditionnelles permettent d'afficher ou masquer des blocs de texte entiers selon une condition.
Afficher si vrai
{#nom_condition}
Ce texte s'affiche uniquement si la condition est activée.
{/nom_condition}
Tout le contenu entre {#...} et {/...} sera inclus dans le document final uniquement si la condition est activée (cochée/true).
Afficher si faux (inverse)
{^nom_condition}
Ce texte s'affiche uniquement si la condition est désactivée.
{/nom_condition}
Le préfixe ^ inverse la logique : le contenu s'affiche uniquement si la condition est désactivée (décochée/false).
Exemple pratique
{#clause_non_concurrence}
Article 8 — Clause de non-concurrence
Le salarié s'engage à ne pas exercer d'activité concurrente
pendant une durée de {duree_non_concurrence} mois suivant
la fin du contrat.
{/clause_non_concurrence}
{^clause_non_concurrence}
Aucune clause de non-concurrence n'est prévue au présent contrat.
{/clause_non_concurrence}
Sections conditionnelles et mise en forme
Les balises conditionnelles doivent être seules sur leur ligne dans le document Word. Le contenu entre les balises conserve toute sa mise en forme (gras, tableaux, images...).
Listes dynamiques
Pour répéter un bloc de contenu (lignes de facture, participants...), utilisez la même syntaxe que les conditions mais avec des sous-champs à l'intérieur :
{#lignes}
{designation} — {quantite} x {prix_unitaire}€
{/lignes}
DocXgen détecte automatiquement qu'il s'agit d'une liste dynamique quand des sous-champs sont présents dans le bloc. Consultez le guide Listes dynamiques pour les détails.
Récapitulatif
| Syntaxe | Usage | Exemple |
|---|---|---|
{champ} | Texte, nombre, date... | {nom_client} |
{%champ} | Image | {%signature} |
{#liste}{champs}{/liste} | Liste dynamique | {#lignes}{designation}{/lignes} |
{#condition}...{/condition} | Section affichée si vrai | {#clause_option}...{/clause_option} |
{^condition}...{/condition} | Section affichée si faux | {^clause_option}...{/clause_option} |
Puis-je utiliser des espaces dans les noms de champs ?
Non. Utilisez des underscores à la place des espaces : {nom_client} et non {nom client}.
Les accents sont-ils autorisés dans les noms de champs ?
Non, évitez les accents. Utilisez {prenom} au lieu de {prénom}.
Puis-je imbriquer des conditions ?
Oui, vous pouvez placer une condition à l'intérieur d'une autre condition. Chaque paire {#...}{/...} doit être correctement fermée.
La mise en forme Word est-elle conservée ?
Oui, DocXgen conserve intégralement la mise en forme de votre document : polices, couleurs, tailles, tableaux, images, en-têtes, pieds de page.
Prêt à créer votre modèle ?
Importez votre document Word et laissez DocXgen détecter automatiquement vos champs.