# gt-next: General Translation Next.js SDK: DictionaryTranslationOptions
URL: https://generaltranslation.com/it/docs/next/api/types/dictionary-translation-options.mdx
---
title: DictionaryTranslationOptions
description: Riferimento dell'API per il tipo DictionaryTranslationOptions
---

## Panoramica

Il tipo `DictionaryTranslationOptions` viene utilizzato per passare variabili alle voci del dizionario e definirne il comportamento di rendering.
Viene utilizzato con [`useTranslations`](/docs/next/api/dictionary/use-translations) e [`getTranslations`](/docs/next/api/dictionary/get-translations) per passare variabili alle voci del dizionario.

<Callout>
  **Traduzione in fase di build:**
  Le variabili non vengono tradotte con [`useTranslations`](/docs/next/api/dictionary/use-translations) e [`getTranslations`](/docs/next/api/dictionary/get-translations), ma solo la stringa originale.
  Consulta [`tx`](/docs/next/api/strings/tx) per tradurre stringhe con contenuto dinamico.
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
  "[variable]?": {
      type: 'any',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Descrizione

| Prop         | Descrizione                                                                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `[variable]` | Le variabili vengono passate come chiavi di primo livello nell&#39;oggetto `options`. I nomi delle chiavi corrispondono ai segnaposto nella voce del dizionario (ad esempio, `{username}`). |

***

## Esempi

### Passare variabili

Per passare una variabile a una voce del dizionario, dobbiamo fare due cose: (1) aggiungere una variabile alla voce e (2) fare riferimento a tale variabile nella chiamata a [`d`](/docs/next/api/strings/use-gt).

Per prima cosa, aggiungiamo una variabile alla voce del dizionario con la seguente sintassi: `{username}`.
`username` è il nome della variabile.

```jsx title="dictionary.ts"
// [!code word:username]
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!',
  },
};

export default dictionary;
```

Successivamente, facciamo riferimento alla variabile:

```jsx title="Component.tsx"
// [!code word:username]
import { useTranslations } from 'gt-next';

const Component = () => {
  const t = useTranslations();
  return <div>{t('greeting.hello', { username : 'Brian123' })}</div>;
};
```


### Utilizzo del formato messaggi ICU

`gt-next` supporta il formato messaggi ICU, che consente anche di formattare le variabili.

```jsx title="dictionary.ts"
// [!code word:account-balance]
const dictionary = {
  account: {
    balance: 'Il saldo del tuo conto: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

Successivamente, facciamo riferimento alla variabile:

```jsx title="Component.tsx"
// [!code word:account-balance]
import { useTranslations } from 'gt-next';

const Component = () => {
  const t = useTranslations();
  return <div>
    { t(
      'account.balance',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};
```

***


## Note

* Le variabili vengono passate come chiavi di primo livello nell&#39;oggetto options, non annidate sotto la chiave `variables`.

### Passaggi successivi

* Consulta [dizionari](/docs/next/guides/dictionaries) per ulteriori informazioni sui dizionari e sulle pratiche comuni.
* Consulta [`useTranslations`](/docs/next/api/dictionary/use-translations) o [`getTranslations`](/docs/next/api/dictionary/get-translations) per ulteriori informazioni sull&#39;interfaccia del dizionario.
* Consulta [`formato messaggi ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) per ulteriori informazioni sulle opzioni di formattazione.