Integrações

Figma (Strings)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Disponível para

  • Todos os planos pagos

Disponível para

  • Plano avançado e Enterprise (legado)

Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

Dica

Para informações sobre a integração do Figma no Phrase TMS, consulte Figma (TMS).

O plug-in do Figma permite que o conteúdo de design seja integrado aos projetos do Phrase, preenchendo a lacuna entre as equipes de design de produto e localização. O plug-in oferece suporte ao envio de conteúdo, recebimento de traduções e gerenciamento de chaves entre o Figma e o Phrase Strings.

  • Ramificação é suportada.

  • É necessário ter acesso a pelo menos um projeto e um idioma com direitos de usuário de tradutor. O acesso pode ser concedido recebendo um convite enviado por um administrador ou gerente de projetos.

  • O plug-in enviará capturas de tela de quadros de layout automático que não são elementos secundários.

  • Por padrão, camadas de texto ocultas não são incluídas na integração. Isso pode ser alterado nas configurações Setup_gear.png selecionando Incluir camadas ou quadros ocultos na seleção.

  • Por padrão, as tags selecionadas no plug-in são limpas após o processo de envio. Isso pode ser alterado nas configurações Setup_gear.png desativando a opção Limpar tags após o envio.

  • Quaisquer alterações feitas nas configurações Setup_gear.png padrão do plug-in serão salvas e permanecerão persistentes.

Instalar e conectar o plug-in do Figma

Para executar o plug-in, selecione-o dentro do navegador de plug-ins do Figma ou na Comunidade Figma e clique em Experimentar. O plug-in ficará disponível no menu Plug-ins do Figma.

A conexão do Figma ao Phrase pode ser feita com credenciais do Phrase, um token de acesso ou um logon único (SSO).

Para entrar com Logon único:

  1. Na tela de login do plug-in, selecione Entrar com Logon único.

  2. Insira o ID da organização.

  3. Conclua o login na aba do navegador que abrir.

    Retorne ao plug-in, já autenticado.

Quando a conexão for feita, selecionar um quadro carrega uma prévia do conteúdo do Figma e das chaves que os usuários podem enviar para ou extrair do Phrase Strings.

A aba Conectar chaves permitirá conectar camadas do Figma a chaves já existentes em um projeto<2> do Strings. Se a convenção de nomenclatura for a mesma para as camadas e para as chaves, elas podem ser correspondidas automaticamente.

O plug-in é acessível através de botões dedicados na barra lateral do Figma:

  • Phrase Strings

    Clique para abrir o plug-in.

  • Ver texto no Strings

    Exibido em arquivos do Figma conectados a um projeto do Strings. Clique para abrir o projeto relevante no editor de tradução.

Adicionar conteúdo

A aba Adicionar conteúdo ao Phrase permite enviar quadros ou camadas de texto do Figma para o Phrase Strings para localização. Não é possível adicionar conteúdo a um ramo principal protegido.

Selecione o projeto, ramo (se estiver sendo usado) e o idioma para o conteúdo que está sendo adicionado. Opcionalmente, insira um código<2> Personalizado para adicionar às chaves enviadas.

Nomes de chave vazios ou duplicados são sinalizados com um contador vermelho na coluna conteúdo. Para gerenciar longas listas de nomes de chave, use o menu suspenso Ordenar por Sort Filter para exibir Nomes de chave incompletos primeiro ou Nomes de chave duplicados primeiro.

Nota

A opção de ordenação selecionada será lembrada para sessões futuras.

O botão Adicionar ao Phrase é desativado se as entradas de nome de chave estiverem vazias, contiverem caracteres inválidos ou não forem exclusivas caso um ramo principal protegido esteja selecionado.

Selecione a configuração Trabalhar com nomes de chave para Editar as entradas de nome de chave e resolver quaisquer conflitos de nomenclatura. Se necessário, Selecionar as chaves desejadas e clique em excluir camadas na parte superior da tabela para remover essas camadas do plug-in.

Se houver camadas desconectadas com nomes de chave conflitantes, Selecionar uma das opções de resolução disponíveis para prosseguir:

  • Criar cópias de chave no Phrase Strings

    Cria novas chaves com o sufixo -copy.

  • Conectar com chaves existentes

    Vincula camadas a chaves do Phrase existentes.

  • Não enviar chaves conflitantes

    Envia apenas camadas não conflitantes.

Quando a opção upload de prévia do Figma estiver habilitada:

  • Os usuários podem, opcionalmente, Selecionar quais traduções incluir na prévia do Figma. Se nenhum idioma for selecionado, todos os idiomas serão incluídos por padrão.

  • O plug-in cria um trabalho por quadro raiz (ou componente de nível superior) incluído no envio. Enviar uma página inteira do Figma com muitos quadros de nível superior gerará um número correspondentemente grande de trabalhos. Para manter a contagem de trabalho proporcional ao escopo real do trabalho de tradução, Selecionar apenas os quadros específicos que contêm conteúdo novo ou atualizado antes de enviar.

Se as camadas forem enviadas com sucesso para o Strings, a janela Envio concluído será exibida com um resumo e as seguintes opções:

  • Criar trabalho

    Clique para abrir a página Criar trabalho com as chaves enviadas pré-selecionadas.

    Importante

    Se a opção upload de prévia do Figma estiver habilitada, um trabalho é criado automaticamente no Strings. Uma vez habilitado, isso não pode ser desabilitado.

  • Abrir no Strings

    Clique para visualizar as chaves enviadas no Strings Editor.

Um ícone de advertência amarelo Warning aparece ao lado de chaves cujos nomes foram alterados no Strings após o upload de conteúdo. Para atualizar nomes de chave no plug-in do Figma, Selecionar Sync key name no menu de reticências More Menu ao lado do nome de chave incompatível.

Opções e ações de upload

Clique no menu View options More Menu para ativar ou desativar as seguintes opções de upload conforme necessário:

  • Upload screenshots está ativado por padrão. Ele permite anexar uma prévia das camadas selecionadas dentro do frame:

    • Se a configuração Include hidden layers or frames in selection estiver ativada, camadas de texto ocultas importadas com o plug-in do Figma terão um marcador colocado no canto superior esquerdo da prévia.

    • Quando a configuração Exclude sections from screenshots estiver ativada, prévias de seções do Figma não serão criadas.

      É recomendado manter esta opção ativada em caso de problemas de desempenho com o plug-in ao trabalhar dentro de seções.

    • Ativar Capture only the closest screenshot para limitar cada prévia ao frame, componente, instância ou seção mais próximo ao redor de uma camada de texto, em vez do ancestral de nível superior mais externo. Todas as camadas de texto dentro desse contêiner recebem marcadores, incluindo camadas fora da Selecionar atual.

      Esta opção está desativada por padrão. Use-a quando Exclude sections from screenshots não limitar suficientemente a captura a um frame aninhado específico, resultando em prévias grandes e com pouco contexto.

  • Update content in Phrase Strings está ativado por padrão.

  • Update key names in Phrase Strings está ativado por padrão, a menos que a configuração Work with key names in Figma esteja desativada.

    Desativar esta opção redefine todas as entradas de chave.

  • Ativar Upload Figma preview para exportar um pacote HTML das chaves selecionadas.

    Esta opção é necessária para gerar in-context preview no CAT Editor do TMS ao trabalhar com jobs synced do Strings.

    Os usuários podem opcionalmente Selecionar quais idiomas de tradução incluir na prévia do Figma ao fazer upload de conteúdo. Se nenhum idioma for selecionado, todos os idiomas serão incluídos por padrão.

    Se a prévia for gerada com sucesso, um trabalho é criado automaticamente no Strings. Qualquer automatização de trabalho ativa no projeto Strings será ignorada para evitar trabalhos Duplicar.

    Se a prévia exceder o limite de 10 MB, as chaves ainda são enviadas para o Strings, mas nenhum trabalho com uma prévia é criado.

    Nota

    Para trabalhar com prévias do Figma no Strings Editor, use a ação Adicionar prévia do Figma na barra lateral de conteúdo.

  • Ativar Preservar formatação e estilo de conteúdo para manter a formatação de rich text (como listas, quebras de linha, negrito/itálico e links) ao enviar conteúdo do Figma para o Phrase e puxar traduções de volta.

    Se ativado, tags de formatação HTML são automaticamente adicionadas para preservar o estilo em linha e são suportadas na prévia de contexto do TMS ao trabalhar com trabalhos sincronizados do Strings. As tags de formatação HTML aparecem no Strings Editor e nas traduções exportadas puxadas de volta para o Figma.

    Desabilitar esta opção se a formatação rica for desnecessária para evitar ajustes manuais.

    A configuração se aplica ao nível do arquivo e afeta todos os colaboradores trabalhando no arquivo. Esta opção é lembrada para novos arquivos.

Para camadas conectadas, as seguintes ações estão disponíveis no menu de reticências More Menu relevante:

  • Selecione Ver detalhes da chave para ver/Editar a descrição da chave no Phrase Strings ou definir um limite de caractere para a chave. Quaisquer alterações salvas na janela Detalhes da chave aparecerão na barra lateral do Strings Editor após atualizar a página do editor.

    Dica

    Selecione várias chaves na aba Enviar conteúdo para o Phrase e use a ação de lote Definir limite de caractere para definir um limite de caractere para todas as chaves selecionadas de uma vez.

  • Selecione Abrir chave no editor para navegar até a chave relacionada no Strings Editor.

  • Selecione Desconectar conteúdo do Phrase Strings para desconectar a camada de uma chave existente.

Gerenciar conteúdo duplicado

Ao enviar conteúdo, camadas com conteúdo duplicado gerarão múltiplas chaves no Strings contendo exatamente o mesmo texto. Os usuários podem decidir como gerenciar esse conteúdo duplicado na janela Enviar conteúdo para o Phrase:

  • Selecione Prosseguir sem mesclar se a criação de múltiplas chaves com conteúdo duplicado for intencional.

  • Para mesclar algum conteúdo duplicado em uma única chave, siga estas etapas:

    1. Selecione duas ou mais chaves da lista e clique em Merge Mesclar para uma chave...

      Um menu suspenso com as chaves disponíveis para mesclagem é exibido.

    2. Selecione a chave na qual deseja mesclar o conteúdo duplicado.

      A chave selecionada é marcada com um ícone de mesclagem azul Merge to a Key na janela Push content to Phrase.

    3. Clique em Proceed, então confirme selecionando Merge and Push no popup Merge duplicated content.

      O conteúdo duplicado é mesclado em uma única chave, e todas as camadas associadas são conectadas a essa chave.

  • Para mesclar parte ou todo o conteúdo duplicado na primeira chave da lista, siga estas etapas:

    1. Selecione várias ou todas as chaves da lista e clique em Merge Mesclar todas as duplicatas na primeira chave.

    2. Clique em Proceed, então confirme selecionando Merge and Push no popup Merge duplicated content.

      O conteúdo duplicado é mesclado em uma única chave, e todas as camadas associadas são conectadas a essa chave.

    Esta opção é útil para arquivos grandes com muitas duplicatas, permitindo que os usuários mesclem todas as duplicatas na primeira chave encontrada em uma única ação, em vez de lidar com cada uma individualmente.

Excluir camadas automaticamente

A configuração Excluir camadas automaticamente remove camadas de texto da aba Push content to Phrase com base no prefixo de seu nome. Quando ativado, qualquer camada com o prefixo _ ou . é excluída automaticamente.

A configuração está desativada por padrão e é aplicada por arquivo. Ela é ativada para todas as camadas nomeadas naquele arquivo até ser desativada.

As exclusões persistem entre as seleções. Para componentes, se as camadas do componente estiverem com prefixo e Excluir camadas automaticamente estiver ativado, os designs subsequentes que usam esse componente herdam a exclusão.

Para excluir automaticamente camadas com prefixo do Push:

  1. No Figma, adicione o prefixo _ ou . às camadas de texto que deseja excluir. Isso também pode ser feito em lote.

  2. Abra as configurações do plug-in e Ativar Auto-excluir camadas.

Configurar nomenclatura de chave

A seção Nomenclatura de chave das configurações do plug-in Setup_gear.png permite configurar a convenção de nomenclatura para chaves conectadas.

Para personalizar nomes de chave no Figma, siga estas etapas:

  1. Clique em Ativar nomenclatura inteligente de chave nas configurações de Nomenclatura de chave.

  2. Selecionar Trabalhar com nomes de chave no Figma.

    Nota

    Se Sincronizar nomes de camada de texto com chaves estiver ativado, os nomes das chaves serão gerados automaticamente com base nos nomes das camadas de texto.

  3. No campo Geração de nome de chave, insira texto para definir uma chave Personalizado:

    • Opcionalmente, clique em Macros disponíveis para Selecionar uma das macros suportadas para gerar nomes de chave automaticamente.

      Múltiplas macros podem ser selecionadas para compor a chave.

    • É possível combinar texto livre e macros no campo Geração de nome de chave.

      Clique em Exemplos para exibir e escolher um dos exemplos predefinidos.

  4. Se necessário, Selecionar uma opção de formatação no menu suspenso Convenção de formatação para modificar o texto de acordo e remover espaços.

Ao enviar conteúdo para o Phrase Strings, aplique a convenção de nomenclatura recém-criada às chaves conectadas anteriormente:

  • Clicando no ícone de atualizar Refresh List na parte inferior da tabela.

  • Selecionar chaves específicas e clicar em Regenerar nomes de chave na parte superior da tabela.

Macros disponíveis

Macro

Descrição

{file_name}

O nome do arquivo Figma

{page}

A página do Figma onde a chave é identificada

{parent_section}

A seção de nível mais alto na árvore de páginas

{nearest_section}

A seção mais próxima da camada de texto na árvore de páginas

{frame}

O frame onde a chave é identificada

{parent_group}

O grupo de nível mais alto na árvore de páginas

{nearest_group}

O grupo mais próximo da camada de texto na árvore de páginas

{component}

O nome do componente do Figma onde a chave está localizada. Apenas componentes de texto original são considerados.

{element_name}

O nome da camada de texto

{element_content}

O conteúdo da camada de texto

{random}

Um hash curto exclusivo gerado aleatoriamente

Conectar ou desconectar chaves

Ao enviar conteúdo, os usuários podem conectar camadas a chaves existentes no Phrase Strings ou gerar novas.

Selecione a aba Conectar chaves para exibir uma visão geral das chaves conectadas e desconectadas.

As chaves que já estão conectadas são identificadas com um ícone de link Connected Key na coluna Nome da chave. Se necessário, selecione o projeto, o ramo (se estiver sendo usado) e o idioma, ou clique no ícone de pesquisa para encontrar o conteúdo desejado.

Selecione Conectar chaves para conectar em massa todas as chaves não vinculadas na aba. Para conectar ou desconectar chaves individuais, clique no ícone relevante à direita da entrada correspondente.

Nota

A opção de desconectar chaves individuais também está disponível na aba Enviar conteúdo para o Phrase.

Nova visualização de conexão (Beta)

A nova visualização lista as camadas de texto da seleção atual com seu estado de conexão em uma única tabela, substituindo a lista baseada em chave anterior.

Nota

Reinicie o plug-in antes de ativar a versão beta para garantir que a versão mais recente seja carregada.

Para ativar a Nova visualização de conexão:

  1. Abra o plug-in e clique no ícone de configurações.

  2. Em Configurações do plug-in, ative Usar nova visualização de conexão (Beta).

  3. Abra as Chaves de conexão para ver a lista de conteúdo conectado.

A visualização de conexão anterior permanece disponível. Desabilite Usar nova visualização de conexão nas configurações do plug-in para reverter.

Para conectar uma única camada, selecione-a para abrir uma janela com duas abas:

  • Sugestões: exibe chaves com correspondências exatas de nome e chaves com conteúdo de tradução correspondente.

  • Pesquisar: pesquise todas as chaves por nome ou conteúdo.

Para agir em várias camadas, selecione-as para revelar uma bandeja de ações em lote:

  • Conectar por nome da chave: conecta camadas a chaves com correspondências exatas de nome.

  • Conectar por conteúdo: conecta camadas a chaves com conteúdo de tradução correspondente

  • Desconectar camadas: remove conexões das camadas selecionadas.

Ignorar camadas com várias chaves correspondentes

A alternância Ignorar camadas com várias chaves correspondentes controla como Conectar por conteúdo lida com camadas cujo texto corresponde a mais de uma chave.

Para ativar a alternância:

  1. Abra o plug-in e vá para a aba Conectar.

  2. Clique em More Menu na navegação para abrir as opções de visualização.

  3. Ativar Ignorar camadas com várias chaves correspondentes.

Quando ativado, qualquer camada com mais de uma chave correspondente é ignorada durante Conectar por conteúdo e deixada sem conexão para revisão manual.

Resumo pós-ação

Após cada execução de lote de Conectar por conteúdo ou Conectar por nome de chave, uma janela de resultados exibe o resultado:

  • Contagem de conectados

  • Ignorado — nenhuma correspondência encontrada

  • Ignorado — múltiplas correspondências (exibido quando Ignorar camadas com múltiplas chaves correspondentes está ativado)

Clique em Mostrar camadas não conectadas para filtrar a tabela para camadas que ainda precisam de atenção, ou Concluir para fechar a janela de resultados.

Extrair Traduções

Assim que as traduções estiverem concluídas, selecione as camadas ou quadros do Figma para extrair as traduções e clique na aba Extrair conteúdo para o Figma.

Os usuários podem selecionar o projeto, ramo (se estiver sendo usado) e os idiomas para o conteúdo que está sendo extraído. As tags não podem ser extraídas de volta para o Figma.

Para gerenciar longas listas de nomes de chave, use o menu suspenso Ordenar por Sort Filter para exibir Nomes de chave incompletos primeiro e resolver quaisquer problemas potenciais. Se necessário, selecione chaves específicas e clique em Excluir camadas na parte superior da tabela para remover essas camadas do plug-in.

Nota

A opção de ordenação selecionada será lembrada para sessões futuras.

Clique no menu Opções de visualização More Menu para escolher como exibir o conteúdo extraído no Figma:

  • Criar uma nova página por idioma

    Selecionado por padrão. Ao extrair para vários idiomas, uma página do Figma separada é criada para cada idioma selecionado, incluindo todas as camadas da página.

    Nota

    No Figma Buzz, a opção Criar uma nova linha com conteúdo traduzido é exibida.

  • Criar uma única página com todos os idiomas

    Cria uma única página nova e coloca o conteúdo traduzido selecionado lado a lado em colunas específicas por idioma. Esta opção foca apenas na seleção ativa em vez de duplicar a página inteira do Figma.

    Recomendado para arquivos grandes para melhorar o desempenho da extração e reduzir o tamanho desnecessário do arquivo.

  • Substituir camadas de texto com traduções

    As camadas de texto selecionadas serão substituídas pelas traduções e atualizadas na viewport.

    Esta opção é automaticamente desativada ao extrair para vários idiomas.

  • Exibir nomes de chave em vez de conteúdo

    Desativado por padrão. Quando ativado:

    • Nomes de chave são extraídos e exibidos em vez do conteúdo traduzido.

    • Selecionar um idioma para o conteúdo extraído não é mais possível.

  • Prévia do conteúdo no idioma selecionado

    A configuração será lembrada para sessões futuras.

    • Se desativado, a coluna Conteúdo exibe o conteúdo das camadas selecionadas diretamente.

    • Quando ativado, a coluna Conteúdo exibe uma prévia do conteúdo no idioma selecionado para camadas conectadas.

      • Para camadas desconectadas, ative a opção Conectar com chaves existentes para mostrar uma prévia no idioma selecionado. Se uma chave com o mesmo nome existir nos dados extraídos, o conteúdo dessa chave é usado como a prévia.

    Esta opção é automaticamente desativada ao extrair para vários idiomas.

  • Conectar com chaves existentes

    Controle como as camadas desconectadas são tratadas ao extrair dados no Figma. A configuração será lembrada para sessões futuras.

    • Quando ativado, o sistema verifica se uma chave com o mesmo nome existe nos dados extraídos.

      Se uma correspondência for encontrada:

      • Camadas desconectadas são conectadas às chaves correspondentes.

      • O conteúdo das camadas é atualizado com o conteúdo extraído das chaves existentes.

    • Se desativado, as camadas desconectadas não são atualizadas, mesmo que existam chaves correspondentes nos dados extraídos.

Verificar estado da tradução

O recurso Verificar estado da tradução verifica se as camadas de texto na seleção atual já possuem traduções para os idiomas de tradução selecionados, antes de extrair o conteúdo para o Figma. A verificação é executada em todas as chaves conectadas na seleção.

Para verificar o estado da tradução

  1. Na aba Extrair conteúdo para o Figma, selecione os idiomas de tradução para verificar.

  2. Clique em Verificar tradução estado.

    A página Estado da tradução exibe uma contagem de chaves traduzidas, parciais e não traduzidas em cada idioma para a seleção atual.

    Clique em Ver detalhes ao lado de um idioma para abrir um detalhamento das chaves conectadas para esse idioma. Usar os filtros Todos, Traduzido e Não traduzido para restringir a lista.

Se o conteúdo for extraído com sucesso para o Figma, a janela Extração concluída será exibida com um resumo das camadas atualizadas.

Ao extrair para vários idiomas, o botão Abrir chave no editor abre a chave com o idioma do projeto como o texto original.

Figma Buzz

O Figma Buzz é uma ferramenta onde designers de marca e equipes de marketing podem criar ativos visuais alinhados à marca em escala, diretamente dentro do Ecossistema Figma. Ele inclui um sistema de modelos, um editor de design simplificado, criação em massa de ativos e edição com IA.

O plug-in Phrase Strings para Buzz permite localizar conteúdo de texto diretamente no Buzz, fornecendo os mesmos recursos que na integração do Figma Design:

Nota

A prévia ao vivo não é suportada.

O plug-in está disponível no menu Plugins no Buzz. Uma vez ativado, ele pode ser salvo para uso futuro e executado no design selecionado abrindo-o em um modal na barra lateral do Figma Buzz. Camadas de texto são detectadas automaticamente e exibidas no plug-in.

O conteúdo do design pode então ser enviado para um projeto Strings conectado para tradução. Após a tradução, os usuários podem trazer o conteúdo localizado de volta para o Buzz, o que cria uma nova linha contendo a versão traduzida do design.

O botão Upload prévia Figma e a seleção de idioma de tradução antes de enviar as chaves não estão disponíveis no Buzz. Ao enviar chaves do Buzz, todos os idiomas de tradução configurados no projeto Strings são usados automaticamente.

Esse artigo foi útil?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.