---
url: "/pl/copydoc/sync/merge-tags.md"
description: "Merge tagi w CopyDoc dynamicznie zastępują treść w warstwach tekstowych, zachowując formatowanie i pozwalając na wiele zamian w jednej warstwie."
---

# Merge tagi w Figmie: zastępowanie tekstu danymi z arkusza

> Merge tagi w CopyDoc dynamicznie zastępują treść w warstwach tekstowych, zachowując formatowanie i pozwalając na wiele zamian w jednej warstwie.

### Poradnik wideo: synchronizacja merge tagów w warstwach tekstowych Figmy z arkusza kalkulacyjnego

Ten film pokazuje, jak zsynchronizować merge tagi w warstwach tekstowych Figmy z arkusza kalkulacyjnego za pomocą wtyczki CopyDoc.
[Embedded media](https://www.youtube-nocookie.com/embed/odONMaXerQQ)
### Poradnik wideo: synchronizacja treści z zaawansowanymi merge tagami w komórkach arkusza

Ten film pokazuje, jak synchronizować treść tekstową w Figmie i zmieniać nazwy warstw Figmy za pomocą zaawansowanych merge tagów w komórkach arkusza i wtyczki CopyDoc.
[Embedded media](https://www.youtube-nocookie.com/embed/M3TCf3VWOlg)

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

## Składnia merge tagów {#merge-tag-syntax}

CopyDoc używa prostej składni merge tagów: `#{columnName}`. Możesz wstawiać merge tagi w dowolnym miejscu warstw tekstowych, a zostaną one zastąpione wartościami z arkusza.

### Przykład użycia {#example-usage}

**Warstwa tekstowa w Figmie:**
```
Hello #{firstName} #{lastName},
Your order #{orderId} is ready for pickup!
```

**Kolumny arkusza:**
| firstName | lastName | orderId |
|-----------|----------|---------|
| John      | Smith    | 12345   |
| Sarah     | Johnson  | 67890   |

**Wynik po synchronizacji:**
- `Hello John Smith, Your order 12345 is ready for pickup!`
- `Hello Sarah Johnson, Your order 67890 is ready for pickup!`

## Najważniejsze zalety {#key-benefits}

- **Zachowane formatowanie**: style tekstu, fonty i kolory pozostają bez zmian
- **Wiele merge tagów**: w jednej warstwie możesz użyć tylu merge tagów, ilu potrzebujesz
- **Elastyczne nazwy kolumn**: działa z różnymi formatami nagłówków kolumn
- **Inteligentny fallback**: jeśli nie ma pasującej kolumny, tekst merge tagu pozostaje bez zmian
- **Odwołania do innych wierszy**: pobieraj dane z konkretnych wierszy za pomocą składni `.N`
- **Dynamiczne nazwy warstw**: używaj merge tagów do zmiany nazw ramek i warstw

### Elastyczne nagłówki kolumn {#column-header-flexibility}

CopyDoc inteligentnie dopasowuje nagłówki kolumn. Działa każdy z tych formatów:
- Standardowy: `firstName` pasuje do `#{firstName}`
- Z prefiksem #: `#firstName` pasuje do `#{firstName}`
- Pełny merge tag: `#{firstName}` pasuje do `#{firstName}`

## Funkcje zaawansowane {#advanced-features}

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

### Wskazanie numeru wiersza (składnia `.N`) {#row-index-override-n-syntax}

Pobieraj dane z konkretnych wierszy za pomocą składni `.N`, gdzie `N` to numer wiersza (zaczynając od 2, bo wiersz 1 zawiera nagłówki).

**Przykład:**

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

**Warstwa tekstowa w Figmie w wierszu 1:**

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

**Wynik:**

Current: John Smith
Next up: Sarah Johnson

Przydaje się to do:
- tworzenia odwołań typu „następny” lub „poprzedni”,
- pokazywania powiązanych danych z innych wierszy,
- budowania zestawień porównawczych,
- tworzenia list referencyjnych.

### Zmiana nazw warstw za pomocą merge tagów {#renaming-layers-with-merge-tags}

Merge tagi działają też przy zmianie nazw ramek i warstw. Użyj ich w wartościach kolumn arkusza, aby dynamicznie generować nazwy warstw.

**Przykład:**

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

**Wynik:** ramki otrzymają nazwy:
- „John Smith”
- „Sarah Johnson”

W nazwach warstw możesz też wskazywać numer wiersza:
- `#{firstName.2}` vs `#{firstName.3}` tworzy porównawcze nazwy ramek
- Idealne do scenariuszy „przed/po” lub „opcja A vs opcja B”

### Masowa zmiana nazw warstw {#bulk-layer-renaming}

Przy prostszej zmianie nazw, jeśli masz 6 ramek w Figmie o nazwie **#My Frame**, możesz użyć tej nazwy jako nazwy kolumny w arkuszu i masowo zmienić ich nazwy na stałe wartości lub kombinacje merge tagów.

## Interpolacja treści komórek arkusza {#spreadsheet-cell-content-interpolation}

Komórki arkusza mogą odwoływać się do innych kolumn za pomocą składni merge tagów. Dzieje się to **przed** zastosowaniem wartości w warstwach Figmy, dzięki czemu możesz tworzyć wartości wyliczane.

**Przykład:**

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

**Jak to działa:**
1. Kolumna `fullName` przyjmuje wartość „John Smith” lub „Sarah Johnson”.
2. Kolumna `greeting` używa tej wartości i daje „Hello, John Smith!” lub „Hello, Sarah Johnson!”.
3. Ta ostateczna wartość trafia do warstw tekstowych w Figmie.

**Zalety:**
- Twórz w arkuszu formuły wielokrotnego użytku
- Łącz wiele kolumn w sformatowane ciągi tekstu
- Buduj złożoną treść z prostych fragmentów danych
- Zachowuj spójność podobnych wzorców treści

**Zaawansowany przykład z odwołaniami do wierszy:**

| 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})` |

W ten sposób powstaje dynamiczny tekst porównania, na przykład „Widget A ($99) vs Widget B ($149)”.

### Typowe zastosowania {#common-use-cases}

- **Szablony e-maili**: personalizuj imiona i dane odbiorców
- **Wizytówki**: generuj wiele wersji z różnymi danymi kontaktowymi
- **Materiały marketingowe**: twórz zlokalizowane wersje z inną treścią
- **Wizualizacje danych**: dynamicznie aktualizuj etykiety i tytuły
- **Katalogi produktów**: hurtowo aktualizuj nazwy, ceny i opisy produktów
- **Układy porównawcze**: pokazuj obok siebie dane z wielu wierszy
- **Dynamiczna organizacja warstw**: automatycznie nazywaj ramki na podstawie ich treści

### Wskazówki {#tips}

- W pliku CSV ujmij w cudzysłów wartości zawierające przecinki: `"42,580"`
- Zanim zastosujesz zmiany w całym projekcie, przetestuj je na kilku warstwach
- Używaj znaczących nazw kolumn, aby arkusz był łatwy do zrozumienia
- Numery wierszy zaczynają się od 2 (wiersz 1 zawiera nagłówki), więc `.2` odwołuje się do pierwszego wiersza z danymi
- Najpierw rozwiązywana jest interpolacja komórek arkusza, a potem interpolacja warstw Figmy
- Łącz merge tagi kreatywnie, aby budować złożoną, dynamiczną treść