Renderize sua primeira mensagem traduzida
Exiba uma saudação em espanhol, substitua um nome e confira como o texto de origem é usado na falta de uma tradução com um catálogo local.
Renderize Hola, Ana. a partir de uma mensagem de origem em inglês. Este exemplo já traz uma tradução em espanhol para você ver exatamente como um componente, um catálogo e um provedor funcionam juntos. Você não precisa de uma conta no Lingo.dev nem de uma chave de API.
Instale em uma aplicação React 19 #
npm install @lingo.dev/react@1.17.1Use uma aplicação React 19 existente para seguir este exemplo. Embora o pacote declare React 18 e 19 como dependências pares, o provedor usa a sintaxe abreviada de provedor de contexto do React 19. Instalar o pacote em um projeto React 18 não garante que ele consiga renderizar nesse ambiente.
Adicione a saudação e o catálogo #
Coloque este componente em src/App.tsx e renderize-o pelo 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 exibe Hola, Ana. Em tempo de execução, a mesma chave é calculada a partir do texto de origem e do contexto, o modelo em espanhol é encontrado e {name} é substituído por Ana.
O catálogo contém a frase inteira, o que permite à tradução mudar a ordem das palavras. O nome é um valor e não faz parte da chave: outro nome usa a mesma entrada do catálogo. Mantenha o texto de origem e o contexto como valores literais na chamada de l.text para que o extrator possa encontrá-los depois.
Confira o que acontece sem uma tradução #
Passe messages={{}} temporariamente para o provedor. Agora, o título exibe Hello, Ana. O texto de origem é usado como modelo na falta de uma tradução, e a substituição de valores continua funcionando. Uma entrada com o valor "" também faz com que o texto de origem seja usado.
Restaure messages e altere apenas o contexto da chamada para "Greeting on the profile page". Isso muda a identidade da mensagem, então a tradução original deixa de corresponder. Restaure o contexto original para voltar a Hola, Ana. Essas verificações permitem distinguir a falta de um catálogo de uma divergência entre a mensagem solicitada e a traduzida.
Substitua o mapa local por catálogos extraídos #
O componente está pronto para extração. Extração e carregamento de catálogos mostra como gerar locales/en.jsonc, selecioná-lo na configuração da CLI, obter uma tradução para o espanhol e carregá-la com segurança. Essa é a próxima tarefa completa a realizar; o exemplo local acima continua útil como teste de renderização.
Para uma aplicação com roteamento, siga com Next.js Pages ou TanStack Start. Ao trocar de idioma, o novo idioma e suas mensagens precisam ser carregados juntos, para que a interface nunca combine o texto de um idioma com a formatação de outro.