TypeScript

Traduisez les valeurs littérales des modules de langue dont l’export par défaut est statique, tout en conservant la syntaxe TypeScript environnante.

Un module de langue TypeScript permet de garder les messages à proximité des types qui les décrivent. Le gestionnaire de fichiers typescript traduit les valeurs littérales d’un export par défaut statique : il remplace le texte directement dans le code, tout en conservant les clés, les imports, les commentaires et la syntaxe de typage environnante. Il lit le code source sans exécuter le module.

Fournir un catalogue statique au gestionnaire #

Utilisez un objet ou un tableau défini directement dans l’export par défaut :

typescript
export default {
  checkout: {
    title: "Complete your order",
    retries: 3,
  },
  steps: ["Review", "Confirm"],
} as const;

Les chaînes traitées comprennent checkout.title, steps[0] et steps[1]. La valeur numérique reste inchangée. as const, satisfies et les parenthèses entourant les expressions prises en charge peuvent rester dans le code source.

Conservez les valeurs à traduire sous forme littérale. Le gestionnaire ne remonte pas d’un identifiant exporté à sa déclaration et n’évalue pas les appels à des fonctions de fabrique. Il ignore les clés de propriété calculées, les opérations de décomposition, les méthodes et les valeurs produites par des expressions. Les littéraux de gabarit ne sont pris en charge que s’ils ne contiennent aucune expression interpolée. Si un module valide ne génère aucune tâche de traduction, examinez la structure de l’export par défaut avant de rechercher un problème de traduction.

Choisir de conserver les valeurs acceptées #

La version précédente de la source permet de repérer les modifications pour chaque chemin du catalogue. La cible existante fournit les valeurs acceptées pour les chaînes inchangées ou non résolues par ailleurs. Les chemins verrouillés conservent le littéral de la source actuelle ; les chemins préservés conservent la valeur cible existante lorsqu’elle est disponible. Ces mécanismes n’exécutent pas le code pour y découvrir du texte supplémentaire.

Les remplacements reprennent le délimiteur de chaîne du littéral source et échappent le contenu traduit en conséquence. Une actualisation des clés conserve les valeurs cibles non sélectionnées. Les entrées source absentes de ce résultat partiel peuvent être supprimées, y compris les éléments de tableau. Vérifiez donc les clés obtenues et les éléments présents dans les tableaux avant de charger le module.

Configurer la sélection des fichiers #

La CLI déduit typescript pour .ts, .mts et .cts, mais pas pour .js ni .tsx. Sélectionnez les modules de langue via la configuration de la CLI ou GitHub.

Charger le module traduit #

Ce format est distinct de l’extraction des messages React. L’extraction lit les appels pris en charge dans le code source .ts et .tsx de l’application pour créer un catalogue ; ce gestionnaire traduit un module de langue déjà structuré. Consultez Catalogues et types React pour en savoir plus sur ce cycle de traitement.

Une fois le module récupéré, vérifiez ses types et chargez-le à l’aide du chargeur de catalogues de l’application. Comparez les clés sélectionnées aux messages utilisés à l’écran, puis testez les paramètres de substitution. Ces vérifications révèlent des problèmes distincts : un module invalide ne peut pas être chargé, une valeur dynamique non sélectionnée reste non traduite et une traduction valide peut malgré tout transmettre un sens erroné.