提示
有关 Phrase TMS 中 Figma 集成的信息，请参阅 Figma (TMS)。
Figma 插件可将设计内容与 phrase 项目集成，拉近产品设计和本地化团队之间的距离。该插件支持 Figma 和 Phrase Strings 之间的内容推送、翻译拉取和管理键。
要运行插件，请在 Figma 的插件浏览器或 Figma 社区中选择它，然后单击试用。插件将在 Figma 菜单中可用。
从 Figma 到 Phrase 的连接可以通过提供 Phrase 凭据或访问令牌来实现。
连接完成后，选择一个框架会加载 Figma 内容和键的预览，用户可以 push 到 Phrase Strings 或从 Phrase Strings pull。
选项卡将允许将 Figma 层连接到 Strings 项目中已经存在的键。如果层和键的命名约定相同，则可以自动匹配。
插件可通过 Figma 侧边栏中的专用按钮访问：
-
Phrase Strings
单击打开插件。
-
在 Strings 中查看文本
显示在连接到 Strings 项目的 Figma 文件中。单击以在翻译编辑器中打开相关项目。
将 选项卡允许将 Figma 中的框架或文本层发送到 Phrase Strings 进行本地化。无法将内容push到受保护的主分分支。
为推送的内容选择项目、分支（如果使用）和语言。(可选)输入自定义标签以添加到上传的键。
单击“查“”菜单，根据需要打开和关闭以下 push 选项：
-
默认启用上传截图。它允许在框架中附加选定层的截图：
-
如果启用了“层或框架”设置，则使用 Figma 插件导入的隐藏文本层将在截图的左上角有一个标记。
-
启用“从截图中”设置后，将无法创建 Figma 部分的截图。
建议启用此选项，以防插件在分区内工作时出现性能问题。
-
-
默认启用 Phrase Strings 更新内容。
-
默认情况下启用 Phrase Strings 中更新键名，除非禁用了 。
关闭此选项将重置所有键输入。
empty 或重复的键名在列中用红色计数器标记。要管理长串键名，使用 下拉列表先显示或。
注释
选定的排序选项将在未来的会话中记住。
如果键名输入为空、包含无效字符，或如果选择受保护的主分支不唯一，则禁用 Push to phrase 按钮。
选择“”设置以编辑键名输入并解决任何命名冲突。如果需要，选择所需的键，然后单击表格顶部的排除层，从插件移除这些层。
如果存在键冲突的断开连接的层，请选择一个可用的解决方案选项继续：
-
使用
-copy后缀创建新键。 -
将层链接到现有 phrase 键。
-
仅推送非冲突层。
如果已成功将层推送到 Strings，将显示“”窗口，其中包含摘要和以下选项：
-
创 建工作
单击以打开“”页面，并预先选择键。
-
在 Strings 中打开
单击以在 Strings 编辑器中查看推送的键。
插件设置的部分允许为连接的键设置命名约定。
要在 Figma 中自定义键，请按照以下步骤操作：
-
从设置中单击启用智能键命名。
-
选择 键名。
注释
如果启用了与键，将根据文本层名称自动生成键名。
-
在字段中，输入文本以定义自定义键命名：
-
(可选)单击可用宏，从支持宏中选择一种自动生成键名。
可以选择多个宏来组成键。
-
在字段中可以合并自由文本和宏。
单击示例以显示并选择预定义示例之一。
-
-
如果需要，从下拉列表中选择格式选项，以相应修改文本并移除空格。
在向 Phrase Strings 推送内容时，通过以下方式之一将新创建的命名约定应用于以前连接的键：
-
单击表格底部的 refresh
图标。
-
选择特定键并单击表顶部的重新生成键名。
可用的宏
|
宏 |
说明 |
|---|---|
|
{file_name} |
Figma 文件的名称 |
|
{page} |
标识键的 Figma 页面 |
|
{parent_section} |
页面树中最高级别的部分 |
|
{nearest_section} |
页面树中最接近文本层的部分 |
|
{frame} |
标识键的帧 |
|
{parent_group} |
页面树中最高级别的组 |
|
{nearest_group} |
页面树中最接近文本层的组 |
|
{component} |
键所在的 Figma 组件的名称。仅考虑原文/源语成分。 |
|
{element_name} |
文本层的名称 |
|
{element_content} |
文本层的内容 |
|
{random} |
随机生成的唯一短哈希 |
推送内容时，用户可以将层连接到 Phrase Strings 中的现有键或生成新键。
选择选项卡以显示已连接和已断开键的概览。
已连接的键在列中用链接 图标标识。如有必要，选择项目、分支（如果使用）和语言，或单击搜索图标以查找所需内容。
选择连接键批量连接选项卡中所有未连接的键。要连接或断开单个键，请单击相应条目右侧的相关图标。
注释
在 选项卡中也有断开单个键的选项。
翻译完成后，选择要 pull 翻译的 Figma 层或框架，然后单击“”选项卡。
用户可以为拉取的内容选择项目、分支（如果使用）和语言。tags 无法拉回 Figma。
要管理长串键名，使用 下拉列表以的键名并解决任何潜在的问题。如果需要，选择特定键并单击表格顶部的排除层以从插件移除这些层。
注释
选定的排序选项将在未来的会话中记住。
单击 菜单，选择如何在 Figma 中显示拉取的内容：
-
默认选择。
-
所选文本层将被翻译覆盖并在视口中更新。
-
默认禁用。启用后：
-
拉取并显示键，而不是翻译内容。
-
无法再为拉取的内容选择语言。
-
-
该设置将在以后的会话中记住。
-
如果禁用，列将直接显示选定层的内容。
-
启用后，列显示已连接层所选语言内容的预览。
-
对于断开连接的层，启用选项以显示选定语言的预览。如果拉取的数据中存在同键，则键的内容用作预览。
-
-
-
控制在 Figma 中拉取数据时如何处理断开的层。该设置将在以后的会话中记住。
-
启用后，系统将检查拉取的数据中是否存在同名键。
如果发现匹配：
-
断开的层连接到匹配的键。
-
使用从现有键中提取的内容更新图层内容。
-
-
如果禁用，即使拉取的数据中存在匹配的键，断开连接的层也不会更新。
-
如果内容成功拉到 Figma，将显示 窗口，其中包含更新图层的摘要。