TypeScript
Traduza valores literais em módulos de idioma com uma exportação predefinida estática, preservando a sintaxe TypeScript envolvente.
Um módulo de idioma em TypeScript permite manter as mensagens junto dos tipos que as descrevem. O processador de ficheiros typescript traduz valores literais numa exportação predefinida estática, substituindo o texto no próprio local e preservando as chaves, as importações, os comentários e a sintaxe de tipos envolvente. Lê o código-fonte sem executar o módulo.
Forneça um catálogo estático ao processador #
Use um objeto ou uma matriz diretamente como exportação predefinida:
export default {
checkout: {
title: "Complete your order",
retries: 3,
},
steps: ["Review", "Confirm"],
} as const;As unidades de texto incluem checkout.title, steps[0] e steps[1]. O valor numérico mantém-se inalterado. as const, satisfies e os parênteses em torno das expressões suportadas podem permanecer no código-fonte.
Mantenha os valores a traduzir como literais. O processador não procura a declaração de um identificador exportado nem avalia chamadas a funções de criação. Ignora chaves de propriedades calculadas, operações de expansão, métodos e valores gerados por expressões. Os literais de modelo só funcionam se não contiverem expressões interpoladas. Se um módulo válido não gerar tarefas de tradução, verifique a estrutura da exportação predefinida antes de procurar uma falha na tradução.
Preserve os valores aceites de forma deliberada #
A versão anterior da origem permite identificar alterações por caminho no catálogo. O destino existente fornece os valores aceites para cadeias de texto inalteradas ou que continuem por resolver. Os caminhos bloqueados mantêm o literal atual da origem; os caminhos preservados mantêm o valor existente no destino, quando disponível. Estes controlos não executam o código para encontrar texto adicional.
As substituições usam o mesmo delimitador de aspas do literal de origem e aplicam ao conteúdo traduzido as sequências de escape adequadas a esse delimitador. Uma atualização de chaves mantém os valores de destino não selecionados. As entradas de origem que não constem desse resultado parcial podem ser removidas, incluindo elementos de matrizes. Por isso, antes de carregar o módulo, verifique as chaves resultantes e os elementos que ficaram nas matrizes.
Configure a seleção de ficheiros #
A CLI infere typescript para .ts, .mts e .cts, mas não para .js ou .tsx. Selecione os módulos de idioma através da configuração da CLI ou do GitHub.
Carregue o módulo traduzido #
Este formato é independente da extração de mensagens do React. A extração lê as chamadas suportadas no código-fonte .ts e .tsx da aplicação para criar um catálogo; este processador traduz um módulo de idioma já estruturado. Consulte Catálogos e tipos do React para conhecer esse ciclo de vida.
Depois de obter o módulo, verifique os respetivos tipos e carregue-o através do carregador de catálogos da aplicação. Compare as chaves selecionadas com as mensagens usadas no ecrã e, em seguida, teste os marcadores de posição. Estas verificações revelam problemas distintos: um módulo inválido não pode ser carregado, um valor dinâmico não selecionado fica por traduzir e uma tradução válida pode, ainda assim, transmitir um significado incorreto.