---
url: "/fr/copydoc/sync/merge-tags.md"
description: "Avec les balises de fusion de CopyDoc, remplacez dynamiquement le texte de vos calques, sans perdre la mise en forme, même plusieurs fois par calque."
---

# Remplacer des balises de fusion Figma par vos données

> Avec les balises de fusion de CopyDoc, remplacez dynamiquement le texte de vos calques, sans perdre la mise en forme, même plusieurs fois par calque.

### Tutoriel vidéo : synchroniser des balises de fusion dans des calques de texte Figma depuis un tableur

Cette vidéo montre comment synchroniser des balises de fusion dans des calques de texte Figma depuis un tableur avec le plugin CopyDoc.
[Embedded media](https://www.youtube-nocookie.com/embed/odONMaXerQQ)
### Tutoriel vidéo : synchroniser du contenu avec des balises de fusion avancées dans les cellules du tableur

Cette vidéo montre comment synchroniser le contenu textuel de Figma et renommer des calques Figma à l’aide de balises de fusion avancées dans les cellules du tableur, avec le plugin CopyDoc
[Embedded media](https://www.youtube-nocookie.com/embed/M3TCf3VWOlg)

[Video](/assets/videos/copydoc/sync/placeholder-sync.mp4)

## Syntaxe des balises de fusion {#merge-tag-syntax}

CopyDoc utilise une syntaxe de balises de fusion simple : `#{columnName}`. Vous pouvez insérer ces balises de fusion n’importe où dans vos calques de texte : elles seront remplacées par les valeurs de votre tableur.

### Exemple d’utilisation {#example-usage}

**Calque de texte Figma :**
```
Hello #{firstName} #{lastName},
Your order #{orderId} is ready for pickup!
```

**Colonnes du tableur :**
| firstName | lastName | orderId |
|-----------|----------|---------|
| John      | Smith    | 12345   |
| Sarah     | Johnson  | 67890   |

**Résultat après la synchronisation :**
- `Hello John Smith, Your order 12345 is ready for pickup!`
- `Hello Sarah Johnson, Your order 67890 is ready for pickup!`

## Principaux avantages {#key-benefits}

- **Mise en forme conservée** : les styles de texte, les polices et les couleurs restent intacts
- **Plusieurs balises de fusion** : utilisez autant de balises de fusion que nécessaire dans un même calque
- **Nommage des colonnes souple** : fonctionne avec différents formats d’en-têtes de colonne
- **Repli intelligent** : si aucune colonne correspondante n’est trouvée, le texte de la balise de fusion est conservé
- **Références à d’autres lignes** : récupérez les données de lignes précises avec la syntaxe `.N`
- **Nommage dynamique des calques** : utilisez des balises de fusion pour renommer des frames et des calques

### Souplesse des en-têtes de colonne {#column-header-flexibility}

CopyDoc sait faire correspondre les en-têtes de colonne de façon intelligente. Tous ces formats fonctionnent :
- Standard : `firstName` correspond à `#{firstName}`
- Avec le préfixe # : `#firstName` correspond à `#{firstName}`
- Balise de fusion complète : `#{firstName}` correspond à `#{firstName}`

## Fonctionnalités avancées {#advanced-features}

[Video](/assets/videos/copydoc/sync/advanced-spreadsheet-merge-tags.mp4)

### Forcer l’index de ligne (syntaxe `.N`) {#row-index-override-n-syntax}

Récupérez les données de lignes précises avec la syntaxe `.N`, où `N` est le numéro de la ligne (à partir de 2, puisque la ligne 1 contient les en-têtes).

**Exemple :**

**Tableur :**
| firstName | lastName |
|-----------|----------|
| John      | Smith    |
| Sarah     | Johnson  |
| Mike      | Williams |

**Calque de texte Figma de la ligne 1 :**

Current: `#{firstName} #{lastName}`
Next up: `#{firstName.3} #{lastName.3}`

**Résultat :**

Current: John Smith
Next up: Sarah Johnson

C’est utile pour :
- créer des références « à suivre » ou « précédent » ;
- afficher des données liées issues d’autres lignes ;
- construire des affichages comparatifs ;
- créer des listes de références.

### Renommer des calques avec des balises de fusion {#renaming-layers-with-merge-tags}

Les balises de fusion permettent aussi de renommer des frames et des calques. Utilisez-les dans les valeurs des colonnes de votre tableur pour générer dynamiquement des noms de calques.

**Exemple :**

**Tableur :**
| frameName | firstName | lastName |
|------------------------|-----------|----------|
| `#{firstName} #{lastName}` | John      | Smith    |
| `#{firstName} #{lastName}` | Sarah     | Johnson  |

**Résultat :** vos frames seront renommés en :
- « John Smith »
- « Sarah Johnson »

Vous pouvez aussi forcer l’index de ligne dans les noms de calques :
- `#{firstName.2}` vs `#{firstName.3}` crée des noms de frames comparatifs
- Idéal pour les scénarios « avant/après » ou « option A vs option B »

### Renommer des calques en masse {#bulk-layer-renaming}

Pour un renommage plus simple, si vous avez 6 frames Figma nommés **#My Frame**, vous pouvez utiliser ce nom comme nom de colonne dans votre tableur et les renommer en masse avec des valeurs fixes ou des combinaisons de balises de fusion.

## Interpolation du contenu des cellules du tableur {#spreadsheet-cell-content-interpolation}

Les cellules du tableur peuvent faire référence à d’autres colonnes avec la syntaxe des balises de fusion ; cette étape a lieu **avant** que la valeur soit appliquée aux calques Figma, ce qui vous permet de créer des valeurs calculées.

**Exemple :**

**Tableur :**
| firstName | lastName | fullName | greeting |
|-----------|----------|----------|----------|
| John      | Smith    | `#{firstName} #{lastName}` | `Hello, #{fullName}!` |
| Sarah     | Johnson  | `#{firstName} #{lastName}` | `Hello, #{fullName}!` |

**Fonctionnement :**
1. La colonne `fullName` est résolue en « John Smith » ou « Sarah Johnson »
2. La colonne `greeting` utilise ensuite cette valeur résolue pour devenir "Hello, John Smith!" ou "Hello, Sarah Johnson!"
3. Cette valeur finale est appliquée à vos calques de texte Figma

**Avantages :**
- Créez des formules réutilisables dans votre tableur
- Combinez plusieurs colonnes en chaînes mises en forme
- Construisez du contenu complexe à partir de données simples
- Gardez la cohérence entre des contenus similaires

**Exemple avancé avec des références de lignes :**

| product  | price | competitor | comparison |
|----------|-------|------------|------------|
| Widget A | $99   | Widget B   | `#{product} (#{price})` vs `#{product.3} (#{price.3})` |
| Widget B | $149  | Widget C   | `#{product} (#{price})` vs `#{product.4} (#{price.4})` |
| Widget C | $199  | Widget A   | `#{product} (#{price})` vs `#{product.2} (#{price.2})` |

Cela crée un texte de comparaison dynamique comme "Widget A ($99) vs Widget B ($149)"

### Cas d’usage courants {#common-use-cases}

- **Modèles d’emails** : personnalisez le nom et les informations des destinataires
- **Cartes de visite** : générez plusieurs variantes avec des coordonnées différentes
- **Supports marketing** : créez des versions localisées avec un contenu différent
- **Visualisations de données** : mettez à jour les libellés et les titres de façon dynamique
- **Catalogues produits** : mettez à jour en masse les noms, les prix et les descriptions des produits
- **Mises en page comparatives** : affichez côte à côte les données de plusieurs lignes
- **Organisation dynamique des calques** : nommez automatiquement les frames en fonction de leur contenu

### Conseils {#tips}

- Dans votre CSV, mettez entre guillemets les valeurs qui contiennent des virgules : `"42,580"`
- Faites d’abord un essai sur quelques calques avant d’appliquer la synchronisation à tout votre design
- Choisissez des noms de colonnes parlants pour que votre tableur reste facile à comprendre
- Les numéros de ligne commencent à 2 (la ligne 1 contient les en-têtes) : `.2` désigne donc la première ligne de données
- L’interpolation des cellules du tableur est résolue en premier, puis celle des calques Figma
- Combinez les balises de fusion de façon créative pour construire du contenu dynamique complexe
