たとえば、スプレッドシートの見出しを #Titleや #Descriptionにした場合は、テキストレイヤーにも #Titleや #Descriptionという名前を付けます。こうすることで、後でプラグインでスプレッドシートを同期するときに、両者が確実に対応付けられます。
特定の行をFigmaレイヤーに割り当てる
スプレッドシートの特定の行を親のフレームレイヤーと同期するには、レイヤー名の末尾にピリオド(.)と対象の行番号を追加します。たとえば、親のフレームレイヤーの名前を#My Frameから#My Frame.3に変更すると、そのフレームレイヤーを選択してスプレッドシートを指定したときに、スプレッドシートの3行目のデータを使って同期されます。デフォルトでは、1つのフレームやレイヤーを同期すると1行目が使われます。
同じ命名規則を使えば、親フレーム内の個々の子テキストレイヤーに使う行を上書きすることもできます。たとえば、ネストされたテキストレイヤーの名前を#Headingから#Heading.5に変更すると、親フレームが#My Frame.3(ほかの同期データには3行目を使用)に設定されている場合でも、このレイヤーにはスプレッドシートの5行目のデータが使われます。
このオプションの命名規則を使うと、同期の際に各レイヤーをどの行のデータで埋めるかを細かく制御できます。
Figmaレイヤーにランダムな行を割り当てる。Figmaレイヤーをランダムな行の値と同期したい場合は、Figmaレイヤー名の末尾、見出し名の直後に.xを追加します。たとえば#Title.xは、常にスプレッドシートの #Title列からランダムな行を取得します。
Figmaの画像レイヤー
スプレッドシートで画像コンテンツを更新する場合は、Figmaの画像レイヤーにも、列の各行に画像URLが入っているスプレッドシートの見出し名(たとえば #Poster)を付けられます。スプレッドシートを同期すると、Figmaレイヤーが自動的に画像コンテンツに置き換えられます。
(テキスト以外の)Figmaレイヤーの名前を更新する
テキスト以外のFigmaレイヤーの名前を変更したい場合は、レイヤー名(たとえばMy Frame)を列見出しの名前として使い、その下の行に新しい名前を追加します。スプレッドシートを同期すると、名前が一致するFigmaレイヤーの名前が自動的に変更されます。
スプレッドシートの行に合わせて1つのFigmaレイヤーを自動で繰り返す
ContentまたはStylesの同期タブを使うときは、Auto Repeatのトグルをオンにすると、1つのFigmaレイヤーを自動で繰り返せます。選択した元のFigmaレイヤーが自動的にコピーされ、スプレッドシートのデータの行数と同じ数だけ複製されます。
これを使うと、1つのカード、カタログアイテム、キャンペーンのレイアウトから、スプレッドシートの行ごとにコンテンツを流し込んだデザインを作れます。デザイン内のテキストレイヤーと画像レイヤーには、対応するスプレッドシートの列が使われます。
メインコンポーネントを選択した場合、CopyDocは行ごとにインスタンスを作成します。既存のインスタンスを選択した場合はそのインスタンスが、フレームを選択した場合はそのフレームが複製されます。
選択したFigmaレイヤーが、Auto Layoutが有効な別のFigmaレイヤーの直下にすでにある場合は、選択したレイヤーがその親レイヤーの中に自動的に複製されます。そうでない場合は、CopyDocが新しいAuto Layoutフレームを作成し、その中に新しいFigmaレイヤーを複製します。
自動で繰り返す親レイヤーの動的な名前
複製した各Figmaレイヤーにスプレッドシートから名前を付けるには、選択したテンプレートレイヤーの名前を列見出しと一致させます。CopyDocは、各行のその列の値を新しいレイヤー名として使います。
先頭の#は1つまでなら省略できます。#Titleという名前のレイヤーはTitle列に、Titleという名前のレイヤーは#Title列に一致させられます。両方の見出しがある場合は、値が空欄でも完全に一致するほうが優先されます。大文字・小文字とスペースは一致している必要があります。
スプレッドシートに一致するレイヤー名がない場合、CopyDocプラグインは元のFigmaレイヤー名に行番号を付けた名前(例:My Frame Layer (Row 3))を使います。