Présentation

La fonction getGT est une fonction asynchrone qui traduit des chaînes au moment de la construction.

const t = await getGT();

<p>{  t('Ce texte sera traduit')  }</p>;

Références

Paramètres

Aucun

Renvoie

Une promesse d’une fonction de rappel t qui traduit le contenu fourni.

Promise<(content: string, options?: InlineTranslationOptions) => string>

Comportement

Production

Pendant le processus de CD (Continuous Delivery/Déploiement continu), tout contenu à l’intérieur d’une fonction t est traduit avant le déploiement de votre application. Cela garantit des temps de chargement rapides pour toutes les locales, mais ne peut traduire que le contenu connu au moment de la compilation.

Une fois générées, les traductions sont soit (1) stockées dans le CDN (Content Delivery/Distribution Network), soit (2) intégrées au build de votre application, selon votre configuration. À partir de là, le contenu traduit est diffusé à vos utilisateurs. Si une traduction est introuvable, un contenu de secours s’applique et le texte d’origine est utilisé.

Assurez-vous de suivre le guide de déploiement ici.

Développement

En développement, la fonction t traduit le contenu à la demande. C’est utile pour prototyper l’apparence de votre application dans différentes langues. N’oubliez pas d’ajouter une clé d’API de développement à votre environnement pour activer ce comportement.

Vous constaterez un délai lors des traductions à la demande en environnement de développement. Cela ne se produira pas dans les builds de production, sauf si le contenu est explicitement traduit à la demande, c.-à-d. en utilisant tx ou <Tx>.

Exemple

Utilisation de base

Vous pouvez utiliser getGT pour traduire des chaînes de caractères.

import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const t = await getGT();

  return (
    <p>
      {t('Salut, Alice !')}
    </p>
  );
}

Remarque : « Alice » sera traduit dans la langue préférée de l’utilisateur.

Utilisation des variables

Vous pouvez transmettre des variables aux traductions du dictionary.

import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const t = await getGT();

  return (
    <p>
      {t('Bonjour, {name} !', { name: 'Alice' })}
    </p>
  );
}

Remarque : « Alice » ne sera pas traduite dans la langue préférée de l’utilisateur, car il s’agit d’une variable.

Utiliser le format de message ICU

gt-next prend en charge le format de message ICU, ce qui vous permet également de formater vos variables.

import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const t = await getGT();
  return (
    <p>
      {t('Il y a {count, plural, =0 {aucun article} =1 {un article} other {{count} articles}} dans le panier', { count: 10 })}
    </p>
  );
}

Notes

• La fonction getGT est une fonction côté serveur qui traduit des chaînes.
• Les traductions de chaînes avec getGT ont lieu avant l’exécution, durant le processus de build (sauf en environnement de développement).

Prochaines étapes

• Consultez useGT pour traduire des chaînes côté client lors du build.
• Pour les traductions à l’exécution, consultez tx et <Tx>.