Apresente a sua primeira mensagem traduzida
Apresente uma saudação em espanhol, substitua um nome e confirme que o texto de origem é usado quando não há tradução, com um catálogo local.
Apresente Hola, Ana. a partir de uma mensagem de origem em inglês. Este exemplo inclui uma tradução em espanhol para que possa ver exatamente como um componente, um catálogo e um fornecedor de contexto funcionam em conjunto. Não precisa de uma conta Lingo.dev nem de uma chave de API.
Instale numa aplicação React 19 #
npm install @lingo.dev/react@1.17.1Utilize uma aplicação React 19 existente para seguir este exemplo. Embora o pacote declare o React 18 e o React 19 como dependências de pares, o fornecedor de contexto utiliza a sintaxe abreviada do React 19 para esse efeito. Instalar o pacote num projeto React 18 não garante que consiga apresentar o componente nessa versão.
Adicione a saudação e o catálogo #
Coloque este componente em src/App.tsx e apresente-o através do ponto de entrada existente da sua aplicação:
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";
const messages = {
[computeKey("Hello, {name}.", "Greeting on the account dashboard")]:
"Hola, {name}.",
};
function Greeting() {
const l = useLingo();
return (
<h1>
{l.text("Hello, {name}.", {
context: "Greeting on the account dashboard",
values: { name: "Ana" },
})}
</h1>
);
}
export default function App() {
return (
<LingoProvider locale="es" messages={messages}>
<Greeting />
</LingoProvider>
);
}Execute o comando de desenvolvimento da sua aplicação e abra a página. O título apresenta Hola, Ana. Em tempo de execução, o sistema calcula a mesma chave a partir do texto de origem e do contexto, encontra o modelo em espanhol e substitui {name} por Ana.
O catálogo contém a frase completa, pelo que a tradução pode alterar a ordem das palavras. O nome é um valor e não faz parte da chave; um nome diferente utiliza a mesma entrada do catálogo. Mantenha o texto literal de origem e o contexto na chamada l.text para que o extrator os possa detetar mais tarde.
Verifique o que acontece sem uma tradução #
Passe temporariamente messages={{}} ao fornecedor de contexto. O título passa a apresentar Hello, Ana. O texto de origem serve de modelo alternativo e a substituição de valores continua a ser feita. Uma entrada cujo valor seja "" também leva à utilização do texto de origem.
Reponha messages e, em seguida, altere apenas o contexto da chamada para "Greeting on the profile page". Esta alteração identifica uma mensagem diferente, pelo que a tradução original deixa de corresponder. Reponha o contexto original para voltar a Hola, Ana. Estas verificações permitem distinguir a ausência de um catálogo de uma falta de correspondência entre a mensagem pedida e a mensagem traduzida.
Substitua o mapa local por catálogos extraídos #
O componente está pronto para a extração. Extração e carregamento de catálogos mostra como gerar locales/en.jsonc, selecioná-lo na configuração da CLI, obter a versão de destino em espanhol e carregá-la em segurança. Essa é a próxima tarefa completa; o exemplo local acima continua a ser útil como teste de apresentação.
Para uma aplicação com encaminhamento, siga para Next.js Pages ou TanStack Start. Ao mudar de idioma, o novo idioma e as respetivas mensagens têm de ser disponibilizados em conjunto, para que a interface nunca combine o texto de um idioma com a formatação de outro.