Integrações

Figma (Strings)

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

Disponível a partir de

  • Todos os planos pagos

Disponível a partir de

  • Plano Avançado e Enterprise (Legado)

Entre em contato com Comércio para perguntas de 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 com projetos do Phrase, conectando a lacuna entre as equipes de design de produto e localização. O plug-in suporta envio de conteúdo, puxar traduções e gerenciar chaves entre o Figma e as Phrase Strings.

  • Ramificação é suportada.

  • O acesso a pelo menos um projeto e um idioma com direitos de usuário de Tradutor é necessário. O acesso pode ser concedido por meio de 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 estã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 envio.

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

Instale e Conecte o Plug-in do Figma

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

A conexão do Figma ao Phrase pode ser feita fornecendo credenciais do Phrase ou um token de acesso.

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

A aba Conectar chaves permitirá conectar camadas do Figma a chaves já existentes em um projeto de Strings. Se a convenção de nomenclatura for a mesma para ambas as camadas e 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 em Strings

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

Enviar Conteúdo

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

push_content.png

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

Clique no menu Ver opções 3dots_icon.jpeg para ativar e desativar as seguintes opções de envio conforme necessário:

  • Enviar capturas de tela está habilitado por padrão. Permite anexar uma captura de tela das camadas selecionadas dentro do quadro:

    • Se a configuração Incluir camadas ou quadros ocultos na seleção estiver habilitada, camadas de texto ocultas importadas com o plug-in do Figma terão um marcador colocado no canto superior esquerdo da captura de tela.

    • Quando a configuração Excluir seções de capturas de tela estiver habilitada, capturas de tela de seções do Figma não serão criadas.

      É recomendável manter esta opção habilitada em caso de problemas de desempenho com o plug-in ao trabalhar dentro de seções.

  • Atualizar conteúdo em Phrase Strings está habilitado por padrão.

  • Atualizar nomes de chaves em Phrase Strings está habilitado por padrão, a menos que a configuração Trabalhar com nomes de chaves no Figma esteja desabilitada.

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

Nomes de chaves vazios ou duplicados são sinalizados com um contador vermelho na coluna Conteúdo. Para gerenciar longas listas de nomes de chave, use o Ordenar por sort_filter.jpeg menu suspenso 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.

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

  • Selecione Ver detalhes da chave para visualizar ou editar a descrição da chave em Phrase Strings. Quaisquer alterações salvas na janela Detalhes da chave aparecerão na barra lateral do editor de Strings após atualizar a página do editor.

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

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

O botão Enviar para Phrase está desativado se os campos de entrada de nome da chave estiverem vazios, contiverem caracteres inválidos ou não forem únicos se um ramo principal protegido estiver selecionado.

Selecione a configuração Trabalhar com nomes de chave para editar os campos de entrada de nome da chave e resolver quaisquer conflitos de nomenclatura. Se necessário, selecione 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, selecione uma das opções de resolução disponíveis para prosseguir:

  • Criar cópias de chave em Phrase Strings 

    Cria novas chaves com o sufixo -cópia.

  • Conectar com chaves existentes 

    Vincula camadas a chaves de Phrase existentes.

  • Não enviar chaves conflitantes 

    Envia apenas camadas não conflitantes.

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

  • Criar trabalho 

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

  • Abrir em Strings 

    Clique para ver as chaves enviadas no Editor de Strings.

Um ícone de aviso amarelo warning_icon.jpeg aparece ao lado das chaves cujos nomes foram alterados em Strings após enviar o conteúdo. Para atualizar os nomes das chaves no plug-in Figma, envie o conteúdo novamente.

Gerenciar conteúdo duplicado

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

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

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

    1. Selecione duas ou mais chaves da lista e clique em merge_icon.jpeg Mesclar em uma chave...

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

    2. Selecione a chave para mesclar o conteúdo duplicado.

      A chave selecionada é marcada com um ícone de mesclagem azul blue_merge_icon.jpeg na janela Enviar conteúdo para Phrase.

    3. Clique em Prosseguir, depois confirme selecionando Mesclar e Enviar no popup Mesclar conteúdo duplicado.

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

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 os nomes das chaves no Figma, siga estas etapas:

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

  2. Selecione Trabalhar com nomes de chaves no Figma.

    Nota

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

  3. No campo Geração de nomes de chaves, insira texto para definir a nomenclatura personalizada das chaves:

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

      Várias macros podem ser selecionadas para compor o nome da chave.

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

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

  4. Se necessário, selecione 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 Phrase Strings, aplique a nova convenção de nomenclatura criada às chaves previamente conectadas, seja:

  • Clicando no ícone de atualizar refresh_icon.jpg na parte inferior da tabela.

  • Selecionando chaves específicas e clicando em Regenerar nomes de chaves 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 quadro 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

{componente}

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

{element_name}

O nome da camada de texto

{element_content}

O conteúdo da camada de texto

{random}

Um hash curto único gerado aleatoriamente

Conectar ou Desconectar Chaves

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

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

connect_keys.jpeg

Chaves que já estão conectadas são identificadas com um ícone de link blue_link.jpeg na coluna Nome da chave. Se necessário, selecione o projeto, ramo (se estiver sendo usado) e 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 Phrase.

Puxar Traduções

Uma vez que as traduções estejam completas, selecione as camadas ou quadros do Figma para puxar traduções e clique na aba Puxar conteúdo para Figma.

pull_content.jpeg

Os usuários podem selecionar o projeto, ramo (se estiver sendo usado) e idioma para o conteúdo que está sendo puxado. Tags não podem ser puxadas de volta para o Figma.

Para gerenciar longas listas de nomes de chaves, use o dropdown Ordenar por sort_filter.jpeg para exibir Nomes de chaves incompletos primeiro e resolver quaisquer problemas potenciais. Se necessário, selecione chaves específicas e clique em Excluir camadas no topo 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 3dots_icon.jpeg para escolher como exibir o conteúdo extraído no Figma:

  • Criar uma nova página com conteúdo traduzido

    Selecionado por padrão.

  • Substituir camadas de texto por traduções

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

  • Exibir nomes de chave em vez de conteúdo

    Desativado por padrão. Quando ativado:

    • Os nomes das chaves 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 futuras sessões.

    • 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 prévia.

  • Conectar com chaves existentes

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

    • 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 puxado das chaves existentes.

    • Se desativado, camadas desconectadas não são atualizadas, mesmo que chaves correspondentes existam nos dados puxados.

Se o conteúdo for puxado com sucesso para o Figma, a janela Puxar concluído é exibida com um resumo das camadas atualizadas.

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.