Definindo Tipos para Chaves de Tradução

Em uma configuração de i18n com segurança de tipos, o conjunto de chaves de tradução válidas é derivado do seu objeto messages. Um erro de digitação como t("greetng") se torna um erro de compilação, não um problema de string ausente em tempo de execução.

Comece com um objeto simples de messages. Ele é a única fonte de verdade tanto para os valores quanto para o tipo das chaves.

Para um objeto simples, keyof typeof fornece a união das chaves.

Os catálogos de mensagens reais são aninhados. Queremos caminhos separados por pontos, como "cart.empty", e não apenas chaves de nível superior. Precisamos de um tipo recursivo que percorra o objeto.

Um tipo condicional combinado com um tipo mapeado cria caminhos separados por pontos ao recursar em objetos aninhados e prefixar as chaves. O prefixo usa um tipo de literal de modelo, escrito com crases no código real como [backtick]${K}.${Paths<T[K]>}[backtick]. Nós o mostramos abaixo como JoinPath(K, child) para manter a listagem limpa.

Passar o tipo de messages para Paths produz todas as chaves válidas separadas por pontos.

Muitas vezes você quer apenas os caminhos das folhas, ou seja, as strings reais, excluindo os objetos intermediários. Ajuste a recursão para ignorar nós que não sejam strings. O prefixo K-ponto-filho usa novamente um tipo de literal de modelo, delimitado por crases no código real, mostrado aqui como JoinPath.

Restrinja o parâmetro da função de tradução à união de chaves derivada, para que apenas chaves válidas sejam compiladas.

Você pode ir além e inferir o tipo do valor em um caminho, o que é útil quando as mensagens têm entradas que não são strings. Um tipo condicional que indexa caminhos percorre os pontos. Ele divide o caminho com um padrão de literal de modelo que, no código real, é escrito com crases como o formato Head ponto Rest com infer. Denotamos essa divisão abaixo como SplitHead/SplitRest.

Sem as const, os valores de string se ampliam para string e você perde as informações literais necessárias mais tarde, por exemplo, para extrair marcadores de posição. Sempre declare os catálogos como constantes.

Derivar as chaves do catálogo significa que adicionar, renomear ou remover uma mensagem atualiza instantaneamente o tipo de chave permitido em todos os lugares. Não há uma enumeração central para manter nem constantes de string obsoletas.

Confirme sua compreensão da tipagem das chaves de tradução.

Você derivou uma união de chaves válidas de um objeto messages usando keyof e um tipo recursivo de caminhos com literais de modelo. As variantes que contêm apenas folhas excluem objetos intermediários, um t tipado rejeita chaves inválidas, e as const preserva as informações literais necessárias à maquinaria de tipos.