JavaScript et React
Traduisez du contenu côté serveur, affichez des catalogues de messages dans React et intégrez le routage par langue à votre application.
Dans les applications JavaScript, la traduction intervient à deux niveaux. Le serveur envoie du contenu à un moteur de localisation et stocke le résultat. L’interface utilisateur charge les messages traduits et les affiche avec les valeurs, la grammaire et la mise en forme adaptées. Choisissez le paquet correspondant à la partie que vous développez.
Traduire depuis votre serveur #
Utilisez le guide de l’API JavaScript pour créer des tâches de traduction avec fetch natif, suivre leur progression et télécharger les fichiers terminés. Gardez la clé API sur le serveur et conservez l’identifiant de chaque tâche avec la révision source qu’elle traduit.
Les applications qui utilisent LingoDotDevEngine disposent d’une référence du SDK v0 dédiée. Son API synchrone et le traitement par lots côté client y restent documentés.
Afficher des messages dans React #
React conserve le message source et son contexte dans le composant. Un catalogue fournit le modèle traduit ; l’environnement d’exécution y insère les valeurs et crée les éléments React contrôlés par votre application. Le rendu ne nécessite aucune clé API de traduction.
Commencez par un composant traduit à l’aide d’un catalogue local. Puis extrayez et chargez les catalogues à mesure que votre application se développe. Les guides pratiques Next.js Pages et TanStack Start relient ces catalogues aux requêtes, aux routes et au changement de langue. Si vous utilisez votre propre routeur, locale-router fournit la logique sous-jacente de gestion des URL et des préférences linguistiques.
Connecter une application Payload #
Le plugin Payload CMS expose le schéma des champs et avertit Lingo.dev lorsque le contenu source change. L’intégration Payload permet de définir le contenu à traduire et l’emplacement où enregistrer les traductions.
Exemples de projets #
Ces dépôts montrent comment les fichiers sources s’articulent avec le chargement dans l’application. Consultez les versions des dépendances et la configuration de chaque projet avant de l’adapter ; certains utilisent une génération de paquets différente de celle décrite dans ces guides. Dans un dépôt dérivé, connectez votre propre projet Lingo.dev avant de soumettre des tâches de traduction.
| Projet | Point de départ utile |
|---|---|
| React + Vite | Messages des composants, extraction et chargement des catalogues. |
| Next.js Pages | Messages des pages et routes tenant compte de la langue. |
| Modules TypeScript | Données de langue statiques exportées. Utilisez la structure d’export par défaut prise en charge par le gestionnaire TypeScript ; les exports non pris en charge peuvent ne produire aucune unité de traduction. |
| iOS | Ressources Apple et sélection native de la langue. |
| Android | Répertoires de ressources et recherche de chaînes. |
| Flutter | Métadonnées ARB et messages générés. |
| Markdown | Chemins des documents et métadonnées d’en-tête. |
| Markdoc + Next.js | Propriétés de balises traduisibles et rendu des documents. |
| OpenAPI | Descriptions lisibles par les utilisateurs dans une spécification d’API. |
| Rails | Fichiers YAML avec la langue à la racine et recherche via le framework. |
| Laravel | Fichiers de ressources et chargement via le framework. |
Les ressources natives et les documents utilisent la CLI et leurs gestionnaires de formats. Le seul fait de figurer dans cette collection d’exemples ne les rend pas dépendants de l’environnement d’exécution React.