提示
有关 Figma 在 Phrase TMS 中集成的信息，请参阅 Figma (TMS)。
Figma 插件允许将设计内容与 Phrase 项目集成，弥合产品设计与本地化团队之间的差距。该插件支持内容推送、拉取翻译以及在 Figma 和 Phrase Strings 之间管理密钥。
要运行插件，请从 Figma 的插件浏览器或 Figma 社区 中选择它，然后点击 试用。该插件将在 Figma 菜单中可用。
从 Figma 到 Phrase 的连接可以使用 Phrase 凭据、一个 访问令牌 或单点登录 (SSO)。
要使用 SSO 登录：
连接建立后，选择一个框架将加载 Figma 内容的预览以及用户可以推送到或从 Phrase Strings 拉取的密钥。
选项卡将允许将 Figma 图层连接到 Strings 项目 中已存在的密钥。如果图层和密钥的 命名约定 相同，它们可以自动匹配。
该插件可以通过 Figma 侧边栏中的专用按钮访问：
-
Phrase Strings
点击以打开插件。
-
在 Strings 中查看文本
显示在连接到 Strings 项目的 Figma 文件中。点击以在 翻译编辑器 中打开相关项目。
选项卡允许将 Figma 中的框架或文本图层发送到 Phrase Strings 进行本地化。无法将内容推送到受保护的主分支。
选择项目、分支（如果正在使用）和要推送的内容的语言。可选地，输入一个自定义标签以添加到上传的键中。
空或重复的键名在列中会被标记为红色计数。要管理长列表的键名，请使用下拉菜单显示或。
注释
所选的排序选项将在未来的会话中被记住。
如果键名输入为空、包含无效字符或在选择受保护的主分支时不唯一，则推送到短语按钮将被禁用。
选择设置以编辑键名输入并解决任何命名冲突。如有需要，选择所需的键并点击表格顶部的排除层以从插件中移除这些层。
如果存在具有冲突键名的断开层，请选择可用的解决选项以继续：
-
创建带有
-副本后缀的新键。 -
将层链接到现有的短语键。
-
仅推送不冲突的层。
当启用上传Figma预览选项时，用户可以选择要包含在Figma预览中的目标语言。如果未选择任何语言，则默认包含所有语言。
如果层成功推送到字符串，窗口将显示摘要和以下选项：
-
创建工作
点击打开页面，已推送的键将被预选。
重要
如果启用上传 Figma 预览选项，将自动在Strings中创建一个工作。一旦启用，无法禁用。
-
在Strings中打开
点击查看Strings编辑器中推送的键。
在Strings中推送内容后，名称已更改的键旁边会出现一个黄色警告图标。要在Figma插件中更新键名称，请从与不匹配的键名称旁边的省略号
菜单中选择同步键名称。
推送选项和操作
点击菜单，根据需要切换以下推送选项：
-
默认启用上传截图。它允许附加所选图层在框架内的截图：
-
如果启用设置，使用Figma插件导入的隐藏文本图层将在截图的左上角放置一个标记。
-
当启用设置时，将不会创建Figma部分的截图。
建议在处理部分时保持此选项启用，以防插件出现性能问题。
-
-
默认启用在Phrase Strings中更新内容。
-
默认启用在Phrase Strings中更新键名称，除非禁用设置。
关闭此选项将重置所有键名称输入。
-
启用上传 Figma 预览以从所选键导出HTML包。
在处理来自Strings的同步的工作时，此选项是生成上下文预览所必需的。
用户可以选择在推送内容时在Figma预览中包含哪些目标语言。如果未选择任何语言，则默认包含所有语言。
如果预览成功生成，将在Strings中自动创建一个工作。在Strings项目中，任何活动的工作自动化将被跳过，以避免重复的工作。
如果预览超过10 MB的限制，密钥仍然会被推送到Strings，但不会创建带有预览的工作。
注释
要在Strings编辑器中处理Figma预览，请在上下文侧边栏中使用添加Figma预览操作。
-
启用保留内容格式和样式以在将内容从Figma推送到Phrase并拉取翻译时保留丰富的文本格式（如列表、换行、粗体/斜体和链接）。
如果启用，HTML格式标签将自动添加，以保留内联样式，并在处理来自Strings的同步工作时在TMS上下文预览中得到支持。HTML格式标签会出现在Strings编辑器中，并在导出的翻译中被拉回到Figma。
如果不需要丰富的格式，请禁用此选项以避免手动调整。
该设置适用于文件级别，并影响在该文件中工作的所有协作者。此选项会被新文件记住。
对于连接的图层，在相关的省略号菜单中可以使用以下操作：
-
选择查看密钥详细信息以在Phrase Strings中查看/编辑密钥描述或为密钥设置字符限制。在窗口中保存的任何更改将在刷新编辑器页面后出现在Strings编辑器侧边栏中。
提示
在选项卡中选择多个密钥，并使用批量操作设置字符限制一次性为所有选定的密钥设置字符限制。
-
选择在编辑器中打开密钥以导航到Strings编辑器中的相关密钥。
-
选择从Phrase Strings断开内容以将图层与现有密钥断开。
管理重复内容
在推送内容时，具有重复内容的图层将在Strings中生成多个包含完全相同文本的密钥。用户可以在窗口中决定如何管理这些重复内容：
-
如果故意创建多个具有重复内容的密钥，请选择继续而不合并。
-
要将一些重复的内容合并到一个单一的键中，请按照以下步骤操作：
-
要将一些或所有重复的内容合并到列表中的第一个键中，请按照以下步骤操作：
此选项对于包含许多重复项的大文件非常有用，允许用户将所有重复项合并到第一个找到的键中，而不是逐个处理。
自动排除图层 设置根据文本图层的名称前缀从 选项卡中移除文本图层。启用时，任何以 _ 或 . 为前缀的图层将被自动排除。
该设置默认关闭，并适用于每个文件。在该文件中，所有命名的图层都将启用，直到关闭。
排除在选择之间持续存在。对于组件，如果组件的图层有前缀并且启用了 自动排除图层，则使用该组件的下游设计将继承排除。
要从 中自动排除带前缀的图层：
插件设置的 部分 允许设置连接键的命名约定。
要在 Figma 中自定义键名称，请按照以下步骤操作：
-
从 设置中点击 启用智能键命名。
-
选择 。
注释
如果启用 ，则键名称会根据文本图层名称自动生成。
-
在 字段中，输入文本以定义自定义键命名：
-
可选地，点击 可用宏 以选择一个 支持的宏 来自动生成键名称。
可以选择多个宏来组合键名称。
-
可以在 字段中结合自由文本和宏。
点击 示例 以显示并选择预定义的示例之一。
-
-
如有需要，从 下拉菜单中选择格式选项，以相应地修改文本并移除空格。
当 推送内容 到 Phrase Strings 时，通过以下任一方式将新创建的命名约定应用于之前连接的键：
-
点击表格底部的刷新
图标。
-
选择特定键并点击表格顶部的 重新生成键名称。
可用宏
|
宏 |
说明 |
|---|---|
|
{file_name} |
Figma 文件的名称 |
|
{page} |
Figma页面中识别键的地方 |
|
{parent_section} |
页面树中最高级别的部分 |
|
{nearest_section} |
页面树中离文本层最近的部分 |
|
{frame} |
识别键的框架 |
|
{parent_group} |
页面树中最高级别的组 |
|
{nearest_group} |
页面树中离文本层最近的组 |
|
{component} |
Figma组件中键所在的名称。仅考虑源组件。 |
|
{element_name} |
文本层的名称 |
|
{element_content} |
文本层中的内容 |
|
{random} |
随机生成的唯一短哈希 |
在推送内容时，用户可以将图层连接到Phrase Strings中的现有键或生成新的键。
选择选项卡以显示已连接和未连接键的概述。
已经连接的键在列中用链接图标标识。如有必要，选择项目、分支（如果正在使用）和语言，或单击搜索图标以查找所需内容。
选择连接键以批量连接选项卡中所有未链接的键。要连接或断开单个键，请单击相应条目右侧的相关图标。
注释
在选项卡中也可以选择断开单个键的选项。
新视图在单个表格中列出当前选择的文本图层及其连接状态，替代了之前基于键的列表。
注释
在启用测试版之前，请重新启动插件以确保加载最新版本。
要启用：
之前的连接视图仍然可用。在插件设置中禁用以恢复。
要连接单个图层，请选择它以打开一个包含两个选项卡的窗口：
-
建议：显示与确切名称匹配的键和具有匹配翻译内容的键。
-
搜索：按名称或内容搜索所有键。
要对多个图层进行操作，请选择它们以显示批量操作托盘：
-
按键名称连接：将图层连接到与确切名称匹配的键。
-
按内容连接：将图层连接到具有匹配翻译内容的键。
-
断开图层连接：从选定的图层中移除连接。
翻译完成后，选择要拉取翻译的Figma图层或框架，然后点击选项卡。
用户可以选择项目、分支（如果正在使用）和要拉取的内容的语言。标签无法拉回到Figma。
要管理长列表的键名称，请使用 下拉菜单以首先显示 并解决任何潜在问题。如有需要，请选择特定的键并点击 排除图层 在表格顶部以从插件中移除这些图层。
注释
所选的排序选项将在未来的会话中被记住。
点击 菜单以选择如何在 Figma 中显示提取的内容：
-
默认选中。在提取多种语言时，为每种选定的语言创建一个单独的 Figma 页面，包括页面上的所有图层。
注释
在 Figma Buzz 中，显示 选项。
-
创建一个新的单一页面，并将选定的翻译内容并排放入特定语言的列中。此选项仅关注活动选择，而不是复制整个 Figma 页面。
建议用于大型文件，以提高提取性能并减少不必要的文件大小。
-
选定的文本图层将被翻译覆盖，并在视口中更新。
当提取多种语言时，此选项会自动禁用。
-
默认禁用。启用时：
-
提取并显示键名称，而不是翻译内容。
-
不再可能为提取的内容选择语言。
-
-
该设置将被记住以供未来的会话使用。
-
如果禁用，列将直接显示所选图层的内容。
-
启用后，列将显示所选语言中连接图层的内容预览。
-
对于未连接的图层，启用选项以在所选语言中显示预览。如果在拉取的数据中存在同名的键，则该键的内容将用作预览。
-
当提取多种语言时，此选项会自动禁用。
-
-
控制在Figma中拉取数据时如何处理未连接的图层。该设置将被记住以供未来的会话使用。
-
启用后，系统会检查在拉取的数据中是否存在同名的键。
如果找到匹配项：
-
未连接的图层将连接到匹配的键。
-
图层内容将更新为来自现有键的拉取内容。
-
-
如果禁用，未连接的图层将不会更新，即使在拉取的数据中存在匹配的键。
-
如果内容成功拉取到Figma，窗口将显示更新图层的摘要。
在为多种语言拉取时，按钮将以项目的默认语言作为源语言打开该键。
Figma Buzz是一个工具，品牌设计师和营销团队可以在Figma生态系统中直接大规模创建符合品牌的视觉资产。它包括一个模板系统、简化的设计编辑器、大批量创建资产和AI驱动的编辑功能。
Buzz的Phrase Strings插件允许在Buzz中直接本地化文本内容，提供与Figma设计集成相同的功能：
-
从Buzz设计推送源文本到Strings
-
将翻译拉回到Buzz
-
管理键并在资产之间保持文本一致性
注释
实时预览不受支持。
插件可以从Buzz中的菜单获取。一旦激活，它可以保存以供将来使用，并通过从Figma Buzz侧边栏打开的模态在选定的设计上运行。文本图层会自动被检测并在插件中显示。
设计内容可以推送到连接的Strings项目进行翻译。翻译后，用户可以将本地化内容拉回Buzz，这会创建一个包含设计翻译版本的新行。