Messages React

Gardez le texte source et son contexte dans vos composants, puis affichez les catalogues traduits avec leurs valeurs, leurs règles grammaticales et leurs éléments React.

Le message d’un composant a sa place auprès de l’action qu’il explique. « Enregistrer » dans un formulaire soumet les modifications ; « Enregistrer » sur un article crée un favori. Garder le texte source et son sens au même endroit permet aux traducteurs de saisir cette distinction et aux développeurs de comprendre le composant sans chercher une clé dans un autre fichier.

@lingo.dev/react utilise des appels explicites pour les messages :

tsx
import { useLingo } from "@lingo.dev/react";

export function SaveButton() {
  const l = useLingo();
  return <button type="submit">{l.text("Save", { context: "Submit changes to account settings" })}</button>;
}

Le texte source et le contexte identifient un message dans un catalogue, une table qui associe des clés à des chaînes traduites. Un fournisseur transmet ce catalogue et la langue active. Le composant reçoit le texte traduit, ou le texte source si l’entrée est absente ou vide.

D’un composant à une autre langue #

Commencez par afficher une traduction en local. Un petit catalogue permet d’observer la recherche du message, sans compte ni requête réseau.

Dans le workflow de l’application, lingo extract regroupe les appels reconnaissables dans un catalogue source JSONC et génère des déclarations TypeScript. La CLI envoie ce fichier pour traduction et récupère le fichier cible. Votre chargeur convertit ensuite le fichier en table de chaînes pour le fournisseur. Extraction et chargement des catalogues décrit ce processus de bout en bout, notamment comment conserver les messages actifs lorsque le JSONC traduit a perdu ses commentaires de métadonnées.

Le rendu s’effectue en local. L’environnement d’exécution ne contacte aucun moteur de localisation et ne contient aucune clé API. Réservez la traduction côté serveur à l’intégration API ; transmettez les catalogues obtenus à l’application via son processus habituel de compilation ou de chargement lors des requêtes.

Rédigez le message dont le lecteur a besoin #

Utilisez une phrase complète avec des espaces réservés plutôt que de concaténer des fragments traduits séparément. Dans une autre langue, le nom, le nombre ou le lien peut se trouver ailleurs dans la phrase.

Contenu du messageÀ utiliser
Texte brut avec des valeursl.text.
Liens, mise en relief ou autre élément Reactl.rich, avec des fonctions de rappel de rendu nommées.
Grammaire selon la quantité ou choix par catégoriel.plural et l.select.
Nombres, dates, listes ou opérations sur le texte adaptées à la langueMéthodes de formatage, qui utilisent les fonctionnalités natives de Intl.

La référence sur le fournisseur et les hooks explique les catalogues imbriqués et l’utilisation de createLingo dans le code hors des composants. Les métadonnées de langue renseignent le sens d’écriture, le système d’écriture et la région pour éclairer les choix relatifs au document et à la mise en page.

Articulez l’application autour des messages #

Les adaptateurs Next.js Pages et TanStack Start relient les catalogues à leurs systèmes de routage respectifs. Dans une autre configuration, chargez la langue et les messages avant le rendu et conservez cette paire pendant le rendu côté serveur et l’hydratation.

Utilisez les types générés pour repérer les erreurs de texte source, de contexte et de valeurs pendant l’édition. Utilisez les tests de rendu pour vérifier les modèles effectivement chargés. Si une traduction ne s’affiche pas, le guide de dépannage retrace la recherche du message, du composant au catalogue.

Exports #

Le module racine exporte LingoProvider, useLingo, createLingo et computeKey, ainsi que les types LingoProviderProps, Lingo, Messages, LingoMessages, MessageKey, TextOptions, RichOptions, PluralForms, SelectForms et FormatMethods. Le point d’entrée distinct @lingo.dev/react/testing exporte withLingo et renderStatic.