# react-native: useGT
URL: https://generaltranslation.com/fr/docs/react-native/api/strings/use-gt.mdx
---
title: useGT
description: Référence API de la fonction useGT de traduction de chaînes de caractères
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas ce fichier directement. Modifiez plutôt le template dans content/docs-templates/. */}


## Vue d’ensemble

La fonction `useGT` est un Hook qui permet de traduire des chaînes de caractères au moment du build.

```jsx
const gt = useGT();

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

<Callout>
  **Traduction au build :** les traductions `useGT` s’effectuent au build, avant
  le déploiement de votre application. Bien que vous puissiez transmettre des
  variables à la chaîne traduite, vous ne pouvez traduire que du contenu connu
  au moment du build.
</Callout>


## Référence

### Paramètres

Aucun

### Renvoie

Une fonction de rappel, `gt`, qui traduit le contenu indiqué.

```jsx
(content: string, options?: InlineTranslationOptions) => string
```

| Nom        | Type                                                                                  | Description                                                       |
| ---------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `content`  | `chaîne de caractères`                                                                | Le contenu textuel à traduire.                                    |
| `options?` | [`InlineTranslationOptions`](/docs/react-native/api/types/inline-translation-options) | Options de traduction pour personnaliser le comportement de `gt`. |

***


## Fonctionnement

### Production

Lors du processus de CD, tout contenu passé à une fonction `gt` sera traduit avant le déploiement de votre application.
Cela garantit des temps de chargement rapides pour tous les paramètres régionaux, mais ne peut traduire que le contenu connu au moment du build.

Une fois générées, les traductions sont soit (1) stockées dans le CDN, soit (2) stockées dans la sortie de build de votre application, selon votre configuration.
Le contenu traduit est ensuite servi à vos utilisateurs.
Si aucune traduction n’est trouvée, le contenu d’origine sera utilisé à la place.

Veillez à suivre le [guide de déploiement ici](/docs/react-native/tutorials/quickdeploy).

### Développement

Pendant le développement, la fonction `gt` traduira le contenu à la demande.
C&#39;est utile pour voir à quoi votre application ressemblera dans différentes langues.
N&#39;oubliez pas d&#39;ajouter une clé API de développement à votre environnement pour activer ce comportement.

Vous remarquerez un délai lors de la traduction à la demande en développement.
Cela ne se produira pas dans les builds de production, sauf si du contenu est explicitement traduit à la demande.

***

## Exemple

### Utilisation de base

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

```jsx copy
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, Alice!')}</p>;
}
```

Remarque : &quot;Alice&quot; sera traduit dans la langue préférée de l’utilisateur.


### Utilisation de variables [#variables]

Vous pouvez passer des variables aux traductions du dictionnaire.

```jsx copy
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();

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

Remarque : &quot;Alice&quot; ne sera pas traduit dans la langue préférée de l’utilisateur, car il s’agit d’une variable.


### Utiliser le format de message ICU

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

```jsx copy
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();
  return (
    <p>
      {gt(
        'There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart',
        { count: 10 }
      )}
    </p>
  );
}
```

<Callout>
  Le format de message ICU est un moyen puissant de mettre en forme vos variables. Pour
  plus d’informations, consultez la [documentation sur le format de message
  ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>


### Import depuis `gt-react-native`

Si vous utilisez la directive `"use client"`, vous devez importer depuis `gt-react-native` plutôt que depuis `gt-react-native`.

```jsx copy
'use client';
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, Alice!')}</p>;
}
```

***


## Notes

* La fonction `useGT` est un Hook qui traduit des chaînes de caractères.
* La traduction des chaînes de caractères avec `useGT` s’effectue avant l’exécution, pendant le processus de build (sauf en développement).