提示
有关 Phrase TMS 中 Figma 集成的信息，请参阅 Figma (TMS)。
Figma 插件允许将设计内容与 Phrase 项目集成，从而弥合产品设计团队与本地化团队之间的差距。该插件支持内容推送、拉取翻译以及在 Figma 和 Phrase Strings 之间管理键值。
-
支持 分支。
-
需要至少拥有一个项目和一个语言的译员用户访问权限。可以通过由 Administrator or Project manager 发送的 invitation 来获得访问权限。
-
插件将发送非子元素的自动布局框架的截图。
-
默认情况下，隐藏的文本图层不包含在集成中。可以在设置
中通过选择 进行更改。
-
默认情况下，插件中选定的标签会在推送过程后清空。可以在设置
-
对插件默认设置
要运行插件，请从 Figma 插件浏览器内或 Figma Community 中选择它，然后点击 Try it out。该插件将在 Figma 菜单中可用。
Figma 到 Phrase 的连接可以通过 Phrase 凭据、access token 或单点登录 (SSO) 来建立。
要使用 SSO 登录：
建立连接后，选择一个框架将加载 Figma 内容和键的预览，用户可以将其推送到 Phrase Strings 或从中拉取。
选项卡允许将 Figma 图层连接到 Strings project 中已存在的键。如果图层和键的naming convention相同，则它们可以自动匹配。
该插件可通过 Figma 侧边栏中的专用按钮访问：
-
Phrase Strings
点击以打开插件。
-
在 Strings 中查看文本
显示在连接到 Strings 项目的 Figma 文件中。点击以在translation editor中打开相关项目。
选项卡允许将 Figma 中的框架或文本图层发送到 Phrase Strings 进行本地化。无法将内容推送到受保护的 main branch。
选择项目、branch（如果正在使用）以及要推送内容的语言。（可选）输入一个自定义tag以添加到上传的键中。
空键名或重复键名会在列中以红色计数器标记。要管理较长的键名列表，请使用 下拉菜单来显示 或 。
注释
所选的排序选项将在以后的会话中被记住。
如果键名输入为空、包含无效字符，或者在选择了受保护的 main branch 时键名不唯一，则Push to Phrase 按钮将被禁用。
选择设置以编辑键名输入并解决任何命名冲突。如果需要，选择所需的键并点击表格顶部的 Exclude layers 以从插件中移除这些图层。
如果有断开连接的图层且键名冲突，请选择可用的解决选项之一以继续：
-
创建带有
-copy后缀的新键。 -
将图层链接到现有的 existing Phrase keys。
-
仅推送无冲突的图层。
当启用 Upload Figma preview 选项时：
-
用户可以选择要在 Figma 预览中包含哪些译文语言。如果未选择任何语言，则默认包含所有语言。
-
该插件会为推送中包含的每个根框架（或顶级组件）创建一个任务。推送包含许多顶级框架的整个 Figma 页面将生成相应数量的任务。为了使任务数量与实际翻译工作范围成比例，请在推送前仅选择包含新内容或更新内容的特定框架。
如果图层成功推送到 Strings，将显示 窗口，其中包含摘要和以下选项：
-
Create job
点击以打开 页面，并预先选择已推送的键。
重要
如果启用了 Upload Figma preview 选项，则会自动在 Strings 中创建一个任务。一旦启用，此功能将无法禁用。
-
Open in Strings
点击以在 Strings Editor 中查看已推送的键。
在推送内容后，名称在 Strings 中发生更改的键旁边会出现一个黄色警告图标 。要在 Figma 插件中更新键名，请从不匹配的键名旁边的省略号
菜单中选择 Sync key name。
Push options and actions
点击 菜单，根据需要切换以下推送选项的开关：
-
默认情况下，Upload screenshots处于启用状态。它允许附加框架内所选层的截图：
-
如果启用了 设置，则通过 Figma 插件导入的隐藏文本层将在截图的左上角放置一个标记。
-
当启用了 设置时，将不会创建 Figma 节的截图。
如果在使用插件处理节内容时遇到性能问题，建议保持此选项启用。
-
启用 可将每个截图的范围限定为文本层周围最近的包含框架、组件、实例或节，而不是最外层的顶级祖先。该容器内的所有文本层都会收到标记，包括当前选择范围之外的层。
此选项默认处于关闭状态。当 无法充分将捕获限制在特定的嵌套框架内，导致截图过大且上下文信息不足时，请使用此选项。
-
-
Update content in Phrase Strings 默认处于启用状态。
-
Update key names in Phrase Strings 默认处于启用状态，除非 设置已禁用。
关闭此选项将重置所有键名输入。
-
启用 Upload Figma preview 以从所选键导出 HTML 包。
在处理从 Strings jobs synced 的内容时，此选项是生成 TMS CAT editor 中 in-context preview 的必要条件。
用户可以选择在推送内容时将哪些译文语言包含在 Figma 预览中。如果未选择任何语言，则默认包含所有语言。
如果预览生成成功，Strings 中会自动创建一个工作。Strings 项目中的任何可用 job automation 都将被跳过，以避免重复工作。
如果预览超过 10 MB 的限制，键值仍会被推送到 Strings，但不会创建带有预览的工作。
注释
要在 Strings Editor 中使用 Figma 预览，请在 上下文侧边栏中使用 添加 Figma 预览 操作。
-
启用 保留内容格式和样式，以便在将内容从 Figma 推送到 Phrase 并拉回翻译时保留富文本格式（例如列表、换行符、粗体/斜体和链接）。
如果启用，HTML 标记会自动添加以保留内联样式，并且在处理从 Strings 同步的工作 时，TMS 上下文预览中支持这些标记。HTML 格式化标签会出现在 Strings Editor 中，以及导入回 Figma 的翻译中。
如果不需要富格式，请禁用此选项以避免手动调整。
此设置适用于文件级别，并影响在该文件中工作的所有协作者。此选项会被新文件记住。
对于 已连接的图层，相关省略号 菜单中提供以下操作：
-
选择 查看键详情 以查看/编辑 Phrase Strings 中的键描述，或为该键设置字符限制。在 窗口中保存的任何更改，将在刷新编辑器页面后显示在 Strings editor 侧边栏 中。
提示
在 选项卡中选择多个键，并使用批量操作 设置字符限制 为所有选定的键一次性设置字符限制。
-
选择 在编辑器中打开键 以导航至 Strings editor 中的相关键。
-
选择 断开与 Phrase Strings 的内容连接 以断开图层与现有键的连接。
管理重复内容
推送内容时，具有重复内容的图层会在 Strings 中生成多个包含完全相同文本的键。用户可以在 窗口中决定如何管理这些重复内容：
-
如果创建多个具有重复内容的键是预期的，请选择 不合并直接继续。
-
若要将重复的内容合并为一个键，请按照以下步骤操作：
-
若要将部分或全部重复内容合并到列表中的第一个键，请按照以下步骤操作：
此选项适用于包含大量重复内容的大型文件，允许用户一次性将所有重复内容合并到找到的第一个键中，而无需逐个处理。
在 Figma 中复制框架或文本图层时，也会复制与 Phrase 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 中的现有键，或生成新键。
选择 选项卡以显示已连接和未连接键的概览。
已连接的键在 列中通过链接 图标进行标识。如有必要，选择项目、分支（如果正在使用）和语言，或点击搜索图标以查找所需内容。
选择 Connect keys 以批量连接选项卡中所有未链接的键。要连接或断开单个键，请点击相应条目右侧的相关图标。
注释
断开单个键的选项也可在 选项卡中找到。
新视图在单个表格中列出了当前选择的文本图层及其连接状态，取代了之前基于键的列表。
注释
在启用测试版之前重启插件，以确保加载的是最新版本。
要启用 ：
之前的 Connect 视图仍然可用。在插件设置中禁用 以恢复。
要连接单个图层，请选择它以打开一个包含两个选项卡的窗口：
-
建议：显示名称完全匹配的键以及内容匹配的键。
-
搜索：按名称或内容搜索所有键。
要对多个图层执行操作，请选择它们以显示批量操作栏：
-
按键名连接：将图层连接到名称完全匹配的键。
-
按内容连接：将图层连接到内容匹配的键。
-
断开图层连接：移除所选图层的连接。
跳过具有多个匹配键的图层
跳过具有多个匹配键的图层开关控制 如何处理文本匹配多个键的图层。
要启用该开关：
-
打开插件并转到 选项卡。
-
点击导航中的
以打开视图选项。
-
启用 。
启用后，任何匹配多个键的图层都会在 期间被跳过，并保持未连接状态以供手动查看。
操作后摘要
在每次“按内容连接”或“按键名连接”批量运行后，结果窗口会显示结果：
-
已连接数量
-
已跳过—未找到匹配项
-
已跳过—存在多个匹配项（当“跳过具有多个匹配键的图层”开启时显示）
点击 显示未连接的图层 以筛选表格，仅显示仍需关注的图层，或点击 完成 以关闭结果窗口。
将文本图层标记为复数键会将其连接到 Phrase Strings 中该键的复数形式。对于复数键， 列会显示一个表单选择器下拉菜单，而不是键的内容，其中列出了所选语言可用的形式，例如 one 和 other。具有更复杂复数规则的语言（例如波兰语）最多会显示五种形式。
该下拉菜单出现在 和 选项卡中。
要在画布上预览复数形式：
将复数键推送到 Phrase Strings 遵循与其他键相同的工作流，并且仅更新所选形式的翻译。
所选的复数形式会按图层、项目和分支进行记忆。该选择在不同会话间保持不变。
翻译完成后，选择要拉取翻译的 Figma 图层或框架，然后点击 选项卡。
用户可以选择项目、分支（如果正在使用）以及要拉取内容的语言。标签无法拉取回 Figma。
要管理较长的键名列表，请使用 下拉菜单来显示 并解决任何潜在问题。如果需要，选择特定的键并点击表格顶部的 排除图层 以从插件中移除这些图层。
注释
所选的排序选项将在以后的会话中被记住。
点击 菜单以选择如何在 Figma 中显示拉取的内容：
-
默认选中。当拉取多种语言时，系统会为每种选定的语言创建一个单独的 Figma 页面，其中包含来自该页面的所有图层。
注释
在 Figma Buzz 中，会显示 选项。
-
创建一个新的页面，并将选定的翻译内容并排放置在特定语言的列中。此选项仅关注当前可用的选择，而不是复制整个 Figma 页面。
建议用于大型文件，以提高拉取性能并减少不必要的文件大小。
-
所选文本图层将被翻译内容覆盖，并在视图中更新。
当拉取多种语言时，此选项会自动禁用。
-
默认禁用。启用后：
-
拉取并显示键名，而非翻译后的内容。
-
无法再为拉取的内容选择语言。
-
-
此设置将在以后的会话中被记住。
-
如果禁用，列将直接显示所选图层的内容。
-
启用后，列会显示所选语言中已连接图层的内容预览。
-
对于未连接的图层，启用 选项即可显示所选语言的预览。如果拉取的数据中存在同名键，则该键的内容将用作预览。
-
当拉取多种语言时，此选项会自动禁用。
-
-
控制在 Figma 中拉取数据时，如何处理未连接的图层。此设置将在以后的会话中被记住。
-
启用后，系统会检查拉取的数据中是否存在同名键。
如果找到匹配项：
-
未连接的图层将连接到匹配的键。
-
图层内容将使用从现有键拉取的内容进行更新。
-
-
如果禁用，即使拉取的数据中存在匹配的键，未连接的图层也不会更新。
-
检查译文状态
“检查译文状态”功能可在将内容拉取到 Figma 之前，验证当前选定内容中的文本图层是否已有所选目标语言的译文。该检查针对选定内容中的所有已连接键运行。
要检查译文状态
-
在 选项卡中，选择要检查的目标语言。
-
点击 检查译文 状态。
页面会显示当前选定内容中每种语言的已翻译、部分翻译和未翻译键的数量。
点击语言旁边的查看详情，即可打开该语言的已连接键明细。使用 、 和 筛选器来缩小列表范围。
如果内容成功拉取到 Figma，系统会显示窗口，其中包含已更新图层的摘要。
当拉取多种语言时，按钮会以项目的默认语言作为源语言打开该键。
注释
如果设计中使用的字体未在本地安装，插件将无法使用拉取的译文更新受影响的文本图层。当发生这种情况时，会显示“无法加载字体 [X]”错误，其中 [X] 是缺失字体的名称。在本地安装此错误消息中标记的所有字体，然后再次拉取内容。
Figma Buzz 是一款工具，品牌设计师和营销团队可以直接在 Figma 生态系统中大规模创建符合品牌形象的视觉资产。它包含一套模板系统、一个简化的设计编辑器、资产批量创建以及 AI 驱动的编辑功能。
适用于 Buzz 的 Phrase Strings 插件通过提供与 Figma Design 集成相同的功能，允许直接在 Buzz 内对文本内容进行本地化：
注释
不支持实时预览。
该插件可在 Buzz 的 菜单中使用。激活后，您可以将其保存以供将来使用，并通过在 Figma Buzz 侧边栏中以模态窗口方式打开它，在所选设计上运行。文本图层会被自动检测并显示在插件中。
然后可以将设计内容推送到关联的 Strings 项目进行翻译。翻译完成后，用户可以将本地化内容拉回 Buzz，这会创建一个包含设计译文版本的新行。
开关和在推送键值前进行目标语言选择的功能在 Buzz 中不可用。从 Buzz 推送键值时，会自动使用 Strings 项目中配置的所有目标语言。