Affichez votre premier message traduit
Affichez une salutation en espagnol, remplacez un nom et vérifiez le retour au texte source à l’aide d’un catalogue local.
Affichez Hola, Ana. à partir d’un message source en anglais. Cet exemple fournit sa propre traduction espagnole pour vous montrer exactement comment un composant, un catalogue et un fournisseur fonctionnent ensemble. Aucun compte Lingo.dev ni aucune clé API ne sont nécessaires.
Installez le paquet dans une application React 19 #
npm install @lingo.dev/react@1.17.1Utilisez une application React 19 existante pour cet exemple. Bien que le paquet déclare React 18 et 19 comme dépendances homologues, son fournisseur utilise la syntaxe abrégée de React 19 pour les fournisseurs de contexte. L’installation du paquet dans un projet React 18 ne garantit pas qu’il puisse y assurer le rendu.
Ajoutez la salutation et le catalogue #
Placez ce composant dans src/App.tsx et affichez-le depuis le point d’entrée existant de votre application :
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>
);
}Lancez la commande de développement de votre application et ouvrez la page. Le titre affiche Hola, Ana. À l’exécution, le système calcule la même clé à partir du texte source et du contexte, trouve le modèle espagnol et remplace {name} par Ana.
Le catalogue contient la phrase entière : la traduction peut donc modifier l’ordre des mots. Le nom est une valeur, il ne fait pas partie de la clé ; un autre nom utilise la même entrée du catalogue. Conservez le texte source littéral et le contexte dans l’appel à l.text pour que l’extracteur puisse les repérer par la suite.
Vérifiez ce qui se passe sans traduction #
Passez temporairement messages={{}} au fournisseur. Le titre affiche désormais Hello, Ana. Le texte source sert de modèle de repli, et la substitution des valeurs continue de fonctionner. Une entrée dont la valeur est "" sélectionne elle aussi le texte source.
Rétablissez messages, puis remplacez uniquement le contexte de l’appel par "Greeting on the profile page". L’identité du message change : la traduction d’origine ne correspond donc plus. Rétablissez le contexte d’origine pour retrouver Hola, Ana. Ces vérifications permettent de distinguer un catalogue manquant d’un décalage entre le message demandé et le message traduit.
Remplacez la table de correspondance en local par des catalogues extraits #
Le composant est prêt pour l’extraction. Extraction et chargement des catalogues explique comment générer locales/en.jsonc, le sélectionner dans la configuration de la CLI, récupérer un catalogue cible en espagnol et le charger en toute sécurité. C’est la prochaine tâche à réaliser de bout en bout ; l’exemple local ci-dessus reste utile pour tester le rendu.
Pour une application avec routage, poursuivez avec Next.js Pages ou TanStack Start. Un changement de langue nécessite de charger ensemble la nouvelle langue et ses messages, afin que l’interface ne combine jamais le texte d’une langue avec la mise en forme d’une autre.