Figmaの新機能：キー管理、バリアント、JSONエクスポート
Smartcat Figmaプラグインのアセット翻訳モードが大幅にアップグレードされました。すべてのテキストオブジェクトに管理可能なキーが割り当てられ、1つの要素で複数のコンテンツバリアントを保持できるようになりました。さらに、ローカリゼーション全体を開発ですぐに使えるJSONファイルとしてエクスポートできます。この機能はすべてのユーザーにすでに公開されており、オプトインは不要です。
メリット
開発へのスムーズな引き継ぎ。すべてのテキストオブジェクトに自動生成されたキーが割り当てられ、いつでも名前を変更できます。つまり、Figmaのコンテンツが、エンジニアリングチームがコードですでに使用しているキーに直接マッピングされます。
1つのデザインで複数のコンテンツ状態を管理。バリアントを使用すると、1つのテキストオブジェクトで複数のコンテンツ（空の状態、読み込み中の状態、エラー状態など）を1つの要素の下に保持でき、それぞれに独自のキーを持たせることができます。代替コピーを表示するためだけにレイヤーを複製する必要はもうありません。
1回の書き出しでデザインからコードへ。JSONエクスポート機能により、完了したローカリゼーションが、すべてのキー、ソース文字列、翻訳、バリアントを含む構造化ファイルに変換され、ソフトウェアのローカリゼーションリソースに直接組み込むことができます。
重複する文字列の削減。プラグインからSmartcatプロジェクトを構築する際、同じキーを共有するセグメントは自動的にマージされます。そのため、デザイン内で何度繰り返されていても、翻訳者が各文字列を確認して翻訳するのは1回だけです。
競合検出機能の組み込み。同じキーが2つの異なるテキストに割り当てられた場合、プラグインはすぐに「Error」タブでフラグを立てるため、翻訳者や開発者に渡る前に名前の衝突を検出できます。
使い方
1. 「Keys and Variants」タブを開きます。ファイル内のすべてのテキストオブジェクトが、キーとペアになってここにリストされます。キーは自動的に生成されますが、任意のオブジェクトに対して手動で設定することもできます。
2. 必要に応じてバリアントを追加します。テキストオブジェクトを選択し、+ Add variantをクリックして代替コンテンツを添付します。各バリアントには自動生成された（または手動の）独自のキーが割り当てられ、バリアントを切り替えてFigmaキャンバス上で直接プレビューできます。
3. キーの競合を解決する: 2つの異なるテキストコンテンツが同じキーを共有している場合、プラグインの「Error」タブに表示されます。テキストを同じにするか、いずれかのキーを変更して修正します。この変更は、一致するすべてのインスタンスに一度に適用できます。
4. コンテンツの翻訳可否をマークする: 任意のテキストオブジェクトを翻訳対象外に切り替えることができます。「Keys and Variants」タブには引き続き表示されますが、新しく追加された「Untranslatable」タブに個別にまとめられます。
5. Smartcatプロジェクトを作成する: プラグインから直接翻訳を開始できます。同じキーを持つセグメントは自動的にマージされます。また、バリアントのセグメントにフォーカスすると、Figmaのプレビューにそのバリアントが正確に表示されるため、翻訳されたバリアントのレビューもソースのレビューと同じくらい簡単に行えます。
翻訳は、キャンバス上または翻訳リストで直接編集することもできます。手動で編集した翻訳はTranslate instantly（即時翻訳）によって上書きされることはありませんが、コンテンツがSmartcatと同期された際に更新される場合があります。
6. JSONとしてエクスポートする: 翻訳が完了したら、Export JSONをクリックしてファイルをダウンロードします。このファイルには、各オブジェクトのFigmaノードID、キー、ソーステキスト、言語ごとの翻訳、およびバリアントがリストされており、そのままエンジニアリングチームに引き渡すことができます。
Smartcatでの確認方法
FigmaでSmartcatプラグインを開き、Asset translation modeに切り替えます。
既存のタブの横に新しいKeys and Variantsタブが配置され、同じパネルからUntranslatableおよびExport JSONも利用できます。
Software localization modeで作業している場合は、2つのタブ名が変更されていることにご注意ください。Text objectsはKeysに、HiddenはUntranslatableになりました。ワークフロー自体に変更はなく、このモードではバリアントはサポートされていません。
この機能が役立つ対象者
この機能は、多言語インターフェースを提供するデザインチームやプロダクトチーム、そしてその成果物を利用する開発者向けに構築されています。デザイナーはファイルを煩雑にすることなく、繰り返し発生するコンテンツや状態ベースのコンテンツをよりすっきりと管理できるようになります。ローカリゼーションチームは翻訳する重複文字列が減り、エンジニアはFigmaのコピーとローカリゼーションキーを手動で照合する代わりに、すぐに使えるJSONリソースファイルを受け取ることができます。