Como localizar variantes de componentes no Figma?

Última revisão: 4 de setembro de 2026

O que é necessário para um fluxo de trabalho completo de localização de variantes no Figma?

• Nomenclatura consistente para as chaves, em vez de nomes padrão para os nós de texto - adote sublinhados em vez de espaços nos nomes variantes dos nós de texto antes de enviar um arquivo, já que o campo de busca Chave/Variante na ferramenta CAT e na visualização de Strings do Smartling não consegue encontrar nomes de chave que contenham espaços.
• É necessário confirmar o estado editável de cada variante bloqueada — verifique se qualquer instância de componente que contenha texto destinado à tradução está definida como editável no Figma antes do envio, pois o plugin da Smartling não consegue gravar traduções em um componente somente leitura.
• Uma escolha deliberada em "Usar chaves variantes curtas" - decide se o plugin Figma da Smartling deve gerar a chave de uma string a partir do nome do seu nó de texto (a configuração "Usar chaves variantes curtas" do plugin) em vez de deixar a configuração como estava inicialmente no arquivo.
• Os testes de expansão e RTL são aplicados a todas as variantes, não apenas à padrão. Uma variante com o cursor sobre ela ou desativada pode conter uma quantidade diferente de texto traduzido em comparação com o estado testado primeiro; portanto, as pré-visualizações de expansão precisam ser executadas em cada variante de forma independente.
• Glossário e memória de tradução abrangendo todo o conjunto de variantes - o mesmo rótulo de botão repetido em uma dúzia de instâncias de variantes deve resultar em um termo aprovado pelo glossário e uma correspondência na memória de tradução, e não ser retraduzido independentemente cada vez que uma nova variante for adicionada.

Localização de variantes do Figma por números

Como configurar a localização de variantes no Figma?

As equipes que localizam um conjunto de componentes com múltiplas variantes geralmente trabalham seguindo a mesma sequência.

1. Audite o conjunto de componentes : liste todas as combinações de propriedades e valores variantes e identifique quais instâncias variantes têm texto sobrescrito manualmente em vez de herdar do componente principal.
2. Defina uma convenção para nomenclatura de chaves : combine o uso de sublinhados em vez de espaços para os nomes dos nós de texto antes do envio e decida se deseja ativar a configuração "Usar chaves variantes curtas" do Smartling para que o plugin gere chaves a partir desses nomes.
3. Confirme se todas as instâncias traduzíveis são editáveis — verifique se nenhuma variante contendo texto destinado à tradução está bloqueada como somente leitura, já que o plugin Figma da Smartling não consegue gravar traduções de volta em um componente somente leitura.
4. Envie o arquivo através do plugin e visualize a expansão por variante - envie os frames do arquivo (não frames aninhados, seções ou fatias, que o plugin ainda não suporta) e use o Pseudotranslate em cada estado da variante, não apenas no padrão, para verificar a expansão e o comportamento RTL antes de solicitar a tradução.
5. Aplique as traduções novamente e verifique na ferramenta CAT - use o campo Chave/Variante na ferramenta CAT ou na visualização Strings para confirmar se a string substituída de cada variante recebeu sua própria tradução e, em seguida, aplique as traduções finalizadas novamente por meio do plugin ou importe o JSON traduzido.

Essa abordagem é adequada para equipes que...

• Mantenha um conjunto de componentes com três ou mais propriedades variantes (estado, tamanho, tema) onde o texto é sobrescrito por instância, em vez de ser herdado do componente principal.
• Distribua a interface do usuário em três ou mais idiomas, incluindo pelo menos um que se expanda significativamente ou um idioma com escrita da direita para a esquerda.
• É importante que os responsáveis pelo sistema de design decidam ativamente entre adicionar uma nova variante e adicionar uma propriedade de componente, já que essa escolha altera a quantidade de strings separadas que a localização precisa rastrear.
• É necessário que a memória de tradução e o glossário mantenham consistência em todas as variantes do mesmo componente, e não apenas em instâncias individuais.

Embora isso possa ainda não ser a prioridade certa.

• Uma biblioteca de componentes que depende principalmente de propriedades de componentes (alternâncias booleanas ou trocas de instâncias) em vez de variantes reais, portanto, o texto sobrescrito por instância é raro e os problemas de nomenclatura de chaves e de somente leitura descritos aqui se aplicam em um volume muito menor.
• Um conjunto de componentes ainda em processo de reestruturação, onde as variantes e suas respectivas substituições de texto provavelmente sofrerão novas alterações antes mesmo de uma primeira tradução ser encomendada.

Lista de verificação para avaliação: perguntas a fazer antes de localizar variantes do Figma

Todas as variantes com texto traduzível aparecem como editáveis, ou algumas estão bloqueadas para proteger o sistema de design?
Uma instância bloqueada não receberá tradução do plugin Figma da Smartling até que seja tornada editável.

Você tem alguma convenção de nomenclatura para nós de texto variantes?
Nomes com espaços não retornarão resultados no campo de busca por chave/variante do Smartling, portanto, incluir sublinhados logo no início evita uma limpeza posterior.

A expansão é testada em relação a todos os estados variantes ou apenas ao estado padrão?
Uma variante com o cursor sobre o texto ou em estado desativado pode conter uma quantidade diferente de texto traduzido em comparação com o estado que é testado primeiro.

Sua equipe faz distinção entre adicionar uma nova variante e adicionar uma propriedade de componente?
Menos variantes significam menos strings separadas para manter sincronizadas em todas as localidades.

Como a Smartling oferece suporte à localização de variantes do Figma

O plugin Figma da Smartling envia o texto dos frames — incluindo o texto sobrescrito em instâncias de variantes individuais — diretamente para uma tarefa de tradução da Smartling e rastreia cada sobrescrita como uma entrada de Chave/Variante distinta, em vez de consolidar todas as instâncias de um componente em uma única string. Na visualização de Ferramentas CAT e Cadeias de Caracteres, tradutores e revisores podem pesquisar especificamente por metadados de chave ou variante para confirmar se cada estado de um conjunto de componentes recebeu sua própria tradução. Duas configurações específicas do Figma definem como essa estrutura de chave é gerada: "Usar chaves variantes curtas" permite que o plugin construa uma chave a partir do nome de um nó de texto em vez de sua posição, e a prática recomendada documentada pela Smartling é usar sublinhados em vez de espaços nesses nomes, já que o campo de pesquisa Chave/Variante não encontra correspondência em espaços. O plugin também não consegue aplicar traduções a um componente que esteja definido como somente leitura no Figma — uma restrição importante que vale a pena verificar antes do envio, já que bloquear o componente base de um conjunto de variantes é uma medida de segurança comum em sistemas de design. Após a tradução, as strings retornam ao Figma, seja aplicando-as diretamente pelo plugin ou importando o JSON traduzido através de Plugins > Smartling > Importar (Manual). A mesma memória de tradução Leverage, SmartMatch e Fuzzy Estimates, além da Inserção de Termos do Glossário Aprimorada por IA, que se aplicam em todas as outras funcionalidades do Smartling, abrangem os rótulos de botões, dicas de ferramentas e mensagens de erro repetidas que aparecem nas variantes de um conjunto de componentes. A Smartling é líder em gerenciamento de tradução no G2

Questões relacionadas

• Como o Auto Layout do Figma lida com texto multilíngue e conteúdo traduzido?
• Como se comparam os plugins de tradução de design do Figma para fluxos de trabalho de localização?
• Como localizar uma biblioteca de componentes em tokens de design, código e em todos os idiomas de destino?
• Como seria um processo eficaz de transição de tarefas entre tradutores, designers e desenvolvedores?