getGT()

Aperçu

La fonction getGT() est une fonction asynchrone pour traduire des chaînes de caractères au moment de la compilation.

const t = await getGT();

<p>{  t('This text will be translated')  }</p>;

Référence

Paramètres

Aucun

Retours

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, tout contenu à l'intérieur d'une fonction t() sera traduit avant que votre application ne soit déployée. Cela garantit des temps de chargement rapides pour toutes les locales, mais ne peut traduire que le contenu connu au moment de la construction.

Une fois générées, les traductions sont soit (1) stockées dans le CDN ou (2) stockées dans la sortie de construction de votre application, selon votre configuration. De là, le contenu traduit est servi à vos utilisateurs. Si une traduction n'est pas trouvée, elle reviendra au contenu original.

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

Développement

Pendant le développement, la fonction t() traduira le contenu à la demande. Ceci est utile pour prototyper à quoi ressemblera votre application dans différentes langues. N'oubliez pas d'ajouter une clé API de développement à votre environnement pour activer ce comportement.

Vous verrez un délai pendant la traduction à la demande en développement. Cela ne se produira pas pendant les constructions de production à moins que le contenu ne soit explicitement traduit à la demande, c'est-à-dire 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('Hello, Alice!')}
    </p>
  );
}

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

Utilisation de variables

Vous pouvez passer des variables aux traductions du dictionnaire.

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

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

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

Note : « Alice » ne sera pas traduit dans la langue préférée de l'utilisateur car c'est une variable.

Utilisation du format de message ICU

gt-next prend en charge le format de message ICU, 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('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 })}
    </p>
  );
}

Notes

• La fonction getGT() est une fonction côté serveur qui traduit les chaînes de caractères.
• Les traductions de chaînes avec getGT() se produisent avant l'exécution, pendant le processus de construction (sauf en développement).

Prochaines étapes

• Voir useGT() pour les traductions de chaînes côté client au moment de la construction.
• Pour les traductions à l'exécution, voir tx() et <Tx>.
• Voir InlineTranslationOptions pour plus d'informations sur la personnalisation des traductions.