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 #

sh
npm install @lingo.dev/react@1.17.1

Utilize 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:

tsx
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.