Traduções da interface

As traduções da interface permitem gerenciar textos reutilizáveis da interface, como botões, rótulos e mensagens, a partir do Studio.

Cada tradução da interface usa uma chave estável, como button.save ou nav.home, e armazena um valor por localidade.

Abrir as traduções da interface

Para trabalhar com as traduções da interface:

Abra o projeto no Studio.
Vá em Localização → Traduções da interface.
Escolha a localidade que deseja editar no seletor de localidade do projeto.

A página lista as chaves de tradução em uma tabela e permite editar uma localidade por vez.

Quando você edita uma localidade que não é a padrão, a tabela também mostra o valor da localidade padrão como referência.

Você pode buscar por chave ou por valor traduzido.

Editar valores

Para atualizar valores:

Abra Localização → Traduções da interface.
Selecione a localidade que deseja editar.
Atualize os valores na tabela.
Clique em Salvar alterações ou use Ctrl/Cmd + S.

Se precisar desfazer edições não salvas, clique em Descartar para restaurar os últimos valores salvos da localidade atual.

Adicionar e excluir chaves

Use Adicionar chave quando precisar de um identificador reutilizável novo para um texto da interface.

As chaves devem:

começar com uma letra ou um número
usar apenas letras, números, pontos e sublinhados
permanecer estáveis para que o frontend continue referenciando-as

Exemplos:

button.save
nav.home
checkout_error

Excluir uma chave remove essa chave e todos os valores localizados em cada localidade do ambiente atual.

Copiar valores de outra localidade

Use Ferramentas → Copiar valores de outro idioma para copiar os valores salvos de uma localidade para a atual, para todas as chaves de tradução da interface deste ambiente.

Isso é útil quando:

uma localidade nova deve começar a partir de uma tradução existente
você quer duplicar uma localidade anterior antes de refinar o texto

Exportar CSV

Use Ferramentas → Exportar CSV para baixar todas as chaves do ambiente atual.

Você pode exportar de duas formas:

Somente a localidade atual: cria um arquivo de duas colunas com key e o ID de API da localidade atual
Todos os idiomas em um arquivo: cria uma coluna key mais uma coluna por localidade

Ao exportar todas as localidades, a padrão aparece primeiro e as demais são ordenadas pelo ID de API da localidade.

Importar CSV

Use Ferramentas → Importar CSV para atualizar muitas chaves de uma vez.

O diálogo de importação aceita dois formatos.

Com uma linha de cabeçalho

Use key como cabeçalho da primeira coluna. Cada cabeçalho de coluna adicional deve corresponder a um ID de API de localidade do ambiente atual.

key,en,fr
button.save,Save,Enregistrer
nav.home,Home,Accueil

Se o arquivo incluir cabeçalhos de localidade desconhecidos, o Studio avisa e permite continuar importando só as colunas de localidade que correspondem.

Sem linha de cabeçalho

Quando A primeira linha é o cabeçalho está desativado, cada linha deve conter duas colunas:

a chave
o valor da localidade atual

button.save,Save
nav.home,Home

Opções de importação

O diálogo de importação também inclui estas opções:

Adicionar chaves ausentes: cria chaves que ainda não existem
Remover chaves que não estão no arquivo: exclui as chaves que faltam no arquivo enviado

Se a mesma chave aparecer mais de uma vez no CSV, a última linha prevalece.

Depois de uma importação bem-sucedida, a página mostra um resumo de quantas chaves foram adicionadas, atualizadas ou removidas.

Permissões

As traduções da interface usam permissões separadas para ver, criar, editar e excluir chaves.

Nos papéis integrados:

Proprietário e Administrador podem ver, adicionar, editar, importar, exportar e excluir chaves
Editor pode ver, adicionar, editar, importar e exportar, mas não pode excluir chaves
Colaborador e Revisor podem ver, editar e exportar, mas não podem adicionar nem excluir chaves
Leitor tem acesso somente leitura e pode exportar arquivos CSV

Papéis personalizados podem conceder o mesmo acesso ao ativar as capacidades de tradução da interface de que você precisa.

Entregar traduções da interface pelo GraphQL

Seus aplicativos podem ler as traduções da interface pela API GraphQL.

O campo uiTranslations devolve pares de chave e valor de uma localidade:

query {
  uiTranslations {
    key
    value
  }
}

Por padrão, a consulta devolve os valores da localidade padrão do projeto. Quando o esquema expõe enums de localidade, você também pode passar o argumento opcional locale para solicitar outra.

Consulte a API GraphQL para orientação de entrega, autenticação e exemplos de consulta.