# gt-next: General Translation Next.js SDK: getTranslations
URL: https://generaltranslation.com/it/docs/next/api/dictionary/get-translations.mdx
---
title: getTranslations
description: Riferimento API della funzione di traduzione lato server getTranslations
---

## Panoramica

`getTranslations` si usa per recuperare le traduzioni delle stringhe dal [dizionario delle traduzioni](/docs/next/guides/dictionaries) per i componenti lato server.

```jsx
const d = await getTranslations(); // Ottieni la funzione di traduzione
d('greeting.hello'); // passa l'id per ottenere una traduzione
```

`getTranslations` supporta:

* La traduzione di contenuti di tipo catena e JSX.
  * Inserimento di variabili e logica condizionale all'interno delle traduzioni.
  * Prefisso ID facoltativo.

Per le traduzioni eseguite dal lato del cliente, vedi [`useTranslations`](/docs/next/api/dictionary/use-translations).

<Callout>
  `getTranslations` e `useTranslations` usano un [dizionario](/docs/next/guides/dictionaries) per archiviare tutti i contenuti da tradurre.
  Questo approccio è diverso dall&#39;uso del [componente `<T>`](/docs/next/guides/t) per la traduzione.
  Se ti interessa usare solo i componenti `<T>` per la traduzione, questo documento non è pertinente.
</Callout>


## Riferimento

### Proprietà

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

### Descrizione

| Prop | Descrizione                                                                                                                                          |
| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | Un prefisso facoltativo da aggiungere all&#39;inizio di tutte le chiavi di traduzione. È utile quando si lavora con valori di dizionario nidificati. |

### Restituisce

Una promise di una funzione di traduzione `d` che, dato un ID, restituisce la versione tradotta della voce corrispondente

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

| Nome       | Tipo                                                                                  | Descrizione                                                       |
| ---------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `id`       | `string`                                                                              | L&#39;ID della voce da tradurre                                   |
| `options?` | [`DictionaryTranslationOptions`](/docs/next/api/types/dictionary-translation-options) | Opzioni di traduzione per personalizzare il comportamento di `d`. |

***

## Esempi

### Utilizzo di base del dizionario

Ogni voce del dizionario viene tradotta.

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

Quando vogliamo accedere a queste voci (lato server), chiamiamo `getTranslations`.
Questa restituisce una funzione che accetta la chiave di traduzione dal dizionario.

```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>
  );
}
```

### Uso delle variabili [#variables]

Per passare dei valori, devi (1) assegnare un identificatore e (2) fare riferimento a tale identificatore quando chiami la funzione `d`.

In questo esempio, usiamo `{}` per passare le variabili alle traduzioni.
Nel dizionario, assegniamo l&#39;identificatore `{userName}`.

```jsx title="dictionary.jsx" copy
// [!code word:userName]
const dictionary = {
  greeting: "Hello, {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();
  
  // Ciao Alice!
  const greetingAlice = d('greeting', { userName: "Alice" }); // [!code highlight]

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


### Uso dei prefissi

Puoi usare i prefissi per recuperare solo una parte del dizionario.

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

Poiché abbiamo aggiunto il valore `'prefix1.prefix2'` al metodo `getTranslations`, tutte le chiavi hanno il prefisso `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>
  );
}
```

***


## Note

* La funzione `getTranslations` ti consente di accedere alle traduzioni del dizionario lato server.

## Passaggi successivi

* Consulta [`useTranslations`](/docs/next/api/dictionary/use-translations) per l&#39;equivalente di `getTranslations` del lato del cliente.