Figma (Strings)

プラグインを実行するには、Figmaのプラグインブラウザ内またはFigmaコミュニティから選択し、試してみるをクリックします。プラグインはFigmaのプラグインメニューで利用可能になります。

FigmaからPhraseへの接続は、Phraseの認証情報、アクセス トークン、またはシングルサインオン（SSO）を使用して行うことができます。

SSOでサインインするには：

接続が確立されると、フレームを選択することでFigmaのコンテンツと、ユーザーがPhrase Stringsにプッシュまたはプルできるキーのプレビューが読み込まれます。

キーを接続タブでは、FigmaのレイヤーをStringsのプロジェクトに既に存在するキーに接続できます。レイヤーとキーの命名規則が同じであれば、自動的に一致させることができます。

プラグインはFigmaのサイドバーにある専用ボタンを通じてアクセスできます：

Phraseにコンテンツをプッシュタブでは、FigmaからPhrase Stringsにフレームやテキストレイヤーをローカライズのために送信できます。保護されたメインブランチにコンテンツをプッシュすることはできません。

プロジェクト、ブランチ（使用している場合）、およびプッシュするコンテンツの言語を選択します。オプションで、アップロードされたキーに追加するカスタムタグを入力します。

空欄または重複したキー名は、コンテンツ列の赤いカウンターでフラグが立てられます。長いキー名のリストを管理するには、並べ替え ドロップダウンを使用して、不完全なキー名を最初に表示または重複したキー名を最初に表示します。

キー名入力が空であるか、無効な文字を含むか、保護されたメインブランチが選択されている場合、フレーズにプッシュボタンは無効になります。

キー名入力を編集し、名前の競合を解決するには、キー名で作業する設定を選択します。必要に応じて、希望するキーを選択し、テーブルの上部にあるレイヤーを除外をクリックして、プラグインからそれらのレイヤーを削除します。

競合するキー名を持つ切断されたレイヤーがある場合、次の解決オプションのいずれかを選択して続行します：

Figmaプレビューをアップロードオプションが有効になっている場合、ユーザーはFigmaプレビューに含めるターゲット言語を選択できます。言語が選択されていない場合、すべての言語がデフォルトで含まれます。

レイヤーがStringsに正常にプッシュされた場合、プッシュ完了ウィンドウが表示され、要約と次のオプションが表示されます：

コンテンツをプッシュした後に Strings で名前が変更されたキーの隣に、黄色の警告アイコン が表示されます。Figma プラグインでキー名を更新するには、ミスマッチしたキー名の隣にある省略記号 メニューから キー名を同期 を選択します。

プッシュオプションとアクション

必要に応じて、以下のプッシュオプションをオンまたはオフに切り替えるには、オプションを表示 メニューをクリックしてください。

接続されたレイヤーについて、関連する省略記号メニューで次のアクションが利用可能です：

重複したコンテンツを管理する

コンテンツをプッシュする際、重複したコンテンツを持つレイヤーは、Strings内に全く同じテキストを含む複数のキーを生成します。ユーザーは、Phraseにコンテンツをプッシュウィンドウでこの重複したコンテンツを管理する方法を決定できます：

自動除外レイヤー設定は、名前の接頭辞に基づいてPhraseにコンテンツをプッシュタブからテキストレイヤーを削除します。有効にすると、接頭辞が_または.のいずれかのレイヤーは自動的に除外されます。

この設定はデフォルトでオフになっており、ファイルごとに適用されます。オフにされるまで、そのファイル内のすべての名前付きレイヤーに対して有効です。

除外は選択を超えて持続します。コンポーネントの場合、コンポーネントのレイヤーが接頭辞付きであり、自動除外レイヤーが有効になっている場合、そのコンポーネントを使用する下流のデザインは除外を継承します。

プッシュから接頭辞付きレイヤーを自動除外するには:

プラグイン設定のキー命名セクションでは、接続されたキーの命名規則を設定できます。

Figmaでキー名をカスタマイズするには、次の手順に従います：

コンテンツをPhrase Stringsにプッシュする際、以前に接続されたキーに新しく作成した命名規則を適用します：

利用可能なマクロ

コンテンツをプッシュする際、ユーザーはPhrase Stringsの既存のキーにレイヤーを接続するか、新しいキーを生成できます。

接続されたキーと切断されたキーの概要を表示するには、キーを接続タブを選択します。

すでに接続されているキーは、キー名列のリンクアイコンで識別されます。必要に応じて、プロジェクト、ブランチ（使用している場合）、言語を選択するか、検索アイコンをクリックして目的のコンテンツを見つけてください。

タブ内のすべての未リンクキーを一括接続するには、キーを接続を選択します。個々のキーを接続または切断するには、対応するエントリーの右側にある関連アイコンをクリックします。

新しいビューは、現在の選択からのテキストレイヤーを接続ステータスとともに単一のテーブルにリスト表示し、以前のキーベースのリストを置き換えます。

新しい接続ビューを有効にするには：

以前の接続ビューは引き続き利用可能です。プラグイン設定で新しい接続ビューを使用するを無効にして元に戻します。

単一のレイヤーを接続するには、それを選択して2つのタブを持つウィンドウを開きます：

複数のレイヤーに対して操作を行うには、それらを選択してバッチアクショントレイを表示します：

翻訳が完了したら、翻訳を取得するFigmaレイヤーまたはフレームを選択し、Figmaにコンテンツをプルタブをクリックします。

ユーザーはプロジェクト、ブランチ（使用されている場合）および取得するコンテンツの言語を選択できます。タグはFigmaに戻すことはできません。

キー名の長いリストを管理するには、並べ替え ドロップダウンを使用して、不完全なキー名を最初に表示し、潜在的な問題に対処します。必要に応じて、特定のキーを選択し、テーブルの上部にあるレイヤーを除外をクリックして、それらのレイヤーをプラグインから削除します。

表示オプション メニューをクリックして、Figmaで取得したコンテンツの表示方法を選択します：

コンテンツがFigmaに正常にプルされた場合、プル完了ウィンドウが表示され、更新されたレイヤーの概要が表示されます。

複数の言語のためにプルする際、エディタでキーを開くボタンは、プロジェクトのデフォルト言語をソース言語としてキーを開きます。

Figma Buzzは、ブランドデザイナーとマーケティングチームがFigmaエコシステム内でスケールに合わせてブランドに沿ったビジュアル資産を直接作成できるツールです。テンプレートのシステム、簡略化されたデザインエディタ、資産の一括作成、AI駆動の編集が含まれています。

BuzzのPhrase Stringsプラグインは、Figma Design統合と同じ機能を提供することにより、Buzz内でテキストコンテンツを直接ローカライズすることを可能にします：

プラグインはBuzzのプラグインメニューから利用できます。一度アクティブ化されると、将来の使用のために保存でき、Figma Buzzのサイドバーからモーダルを開いて選択したデザインで実行できます。テキストレイヤーは自動的に検出され、プラグインに表示されます。

デザインコンテンツは、翻訳のために接続されたStringsプロジェクトにプッシュできます。翻訳後、ユーザーはローカライズされたコンテンツをBuzzに戻すことができ、デザインの翻訳版を含む新しい行が作成されます。