# gt-next: General Translation Next.js SDK: getTranslations
URL: https://generaltranslation.com/fr/docs/next/api/dictionary/get-translations.mdx
---
title: getTranslations
description: Référence API de la fonction de traduction côté serveur getTranslations
---

## Vue d’ensemble

`getTranslations` permet d’obtenir les traductions de chaînes depuis le [dictionnaire de traduction](/docs/next/guides/dictionaries) pour les composants côté serveur.

```jsx
const d = await getTranslations(); // Récupère la fonction de traduction
d('greeting.hello'); // passe l'identifiant pour obtenir une traduction
```

`getTranslations` prend en charge :

* La traduction de contenu textuel et JSX.
  * L’insertion de variables et la logique conditionnelle dans les traductions.
  * L’ajout facultatif d’un préfixe aux ID.

Pour les traductions côté client, consultez [`useTranslations`](/docs/next/api/dictionary/use-translations).

<Callout>
  `getTranslations` et `useTranslations` utilisent un [dictionnaire](/docs/next/guides/dictionaries) pour stocker tout le contenu à traduire.
  Cela diffère de l’utilisation du [composant `<T>`](/docs/next/guides/t) pour la traduction.
  Si vous souhaitez utiliser uniquement les composants `<T>` pour la traduction, ce document ne vous concerne pas.
</Callout>


## Référence

### Props

<TypeTable
  type={{
  "id?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Description

| Prop | Description                                                                                                                     |
| ---- | ------------------------------------------------------------------------------------------------------------------------------- |
| `id` | Préfixe facultatif à ajouter devant toutes les clés de traduction. Utile pour manipuler des valeurs de dictionnaire imbriquées. |

### Retourne

Une promesse d’une fonction de traduction `d` qui, à partir d’un identifiant, renvoie la version traduite de l’entrée correspondante

```jsx
Promise<(id: string, options?: DictionaryTranslationOptions) => string>
```

| Nom        | Type                                                                                  | Description                                                               |
| ---------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| `id`       | `string`                                                                              | Identifiant de l’entrée à traduire                                        |
| `options?` | [`DictionaryTranslationOptions`](/docs/next/api/types/dictionary-translation-options) | Options de traduction permettant de personnaliser le comportement de `d`. |

***

## Exemples

### Utilisation de base du dictionnaire

Chaque entrée de votre dictionnaire est traduite.

```jsx title="dictionary.jsx" copy
const dictionary = {
  greeting: <>Hello, Alice!</>, // [!code highlight]
};
export default dictionary;
```

Lorsque nous voulons accéder à ces entrées (côté serveur), nous appelons `getTranslations`.
Cela renvoie une fonction qui prend la clé d’une traduction du dictionnaire.

```jsx title="TranslateGreeting.jsx" copy
import { getTranslations } from 'gt-next/server';

export default async function TranslateGreeting() {
  
  const d = await getTranslations(); // [!code highlight]

  return (
    <p>
      {d('greeting')} // Hello, Alice // [!code highlight]
    </p>
  );
}
```


### Utiliser des variables [#variables]

Pour transmettre des valeurs, vous devez (1) attribuer un identifiant et (2) référencer cet identifiant lors de l’appel de la fonction `d`.

Dans cet exemple, nous utilisons `{}` pour passer des variables aux traductions.
Dans le dictionnaire, nous attribuons l’identifiant `{userName}`.

```jsx title="dictionary.jsx" copy
// [!code word:userName]
const dictionary = {
  greeting: "Bonjour, {userName} !", // [!code highlight]
};
export default dictionary;
```

```jsx title="TranslateGreeting.jsx" copy
// [!code word:userName]
import { getTranslations } from 'gt-next/server';

export default async function TranslateGreeting() {
  const d = await getTranslations();
  
  // Bonjour Alice !
  const greetingAlice = d('greeting', { userName: "Alice" }); // [!code highlight]

  return (
    <p>
      {greetingAlice}
    </p>
  );
}
```


### Utilisation de préfixes

Vous pouvez utiliser des préfixes pour récupérer uniquement une partie du dictionnaire.

```jsx title="dictionary.jsx" copy
const dictionary = {
  prefix1: { // [!code highlight]
    prefix2: { // [!code highlight]
      greeting: "Hello, Bob",
    }
  }
};
export default dictionary;
```

Comme nous avons ajouté la valeur `'prefix1.prefix2'` à la méthode `getTranslations`, toutes les clés sont précédées du préfixe `prefix1.prefix2` :

```jsx title="UserDetails.jsx" copy
import { getTranslations } from 'gt-next/server';

export default function UserDetails() {
  const d = await getTranslations('prefix1.prefix2'); // [!code highlight]
  return (
    <div>
      <p>{d('greeting')}</p> // greeting => prefix1.prefix2.greeting // [!code highlight]
    </div>
  );
}
```

***


## Remarques

* La fonction `getTranslations` vous permet d’accéder aux traductions du dictionnaire côté serveur.

## Étapes suivantes

* Consultez [`useTranslations`](/docs/next/api/dictionary/use-translations), l’équivalent côté client de `getTranslations`.