# General Translation React SDKs (gt-react, gt-next): DictionaryTranslationOptions
URL: https://generaltranslation.com/it/docs/react/reference/types/dictionary-translation-options.mdx
---

title: DictionaryTranslationOptions
description: Opzioni per passare variabili alle voci del dizionario con General Translation gt-react. Riferimento API per DictionaryTranslationOptions.

---

`DictionaryTranslationOptions` è l'oggetto options per le operazioni di lookup nel dizionario. Contiene le variabili di interpolazione inserite in una voce del dizionario. Viene accettato dalla funzione restituita da [`useTranslations`](/docs/react/reference/hooks/use-translations).

*Queste opzioni si applicano ovunque [`useTranslations`](/docs/react/reference/hooks/use-translations) sia disponibile: `gt-react`, `gt-next`, `gt-tanstack-start` e `gt-react-native`.*

## Panoramica [#overview]

Passa le variabili di interpolazione come semplici chiavi. Ogni chiave corrisponde a un segnaposto `{name}` nella voce del dizionario.

```typescript
type DictionaryTranslationOptions = {
  [variable: string]: unknown; // variabili di interpolazione
};
```

*Nota: in `gt-react` v11 l&#39;argomento `options` di `useTranslations` è tipizzato come `TranslationVariables` (`Record<string, unknown>`); `DictionaryTranslationOptions` è il nome di riferimento di questa struttura. Le variabili vengono inserite nella traduzione con la formattazione, ma non vengono mai tradotte di per sé.*

## Proprietà [#properties]

| Proprietà                 | Descrizione                                                                     | Tipo                      |
| ------------------------- | ------------------------------------------------------------------------------- | ------------------------- |
| [`variables`](#variables) | Valori di interpolazione, associati al nome del segnaposto usato nell&#39;voce. | `Record<string, unknown>` |

### `variables` [#variables]

**Tipo** `Record<string, unknown>`

Ogni chiave indica dove il relativo valore viene inserito nella voce del dizionario. Per fare riferimento a una variabile nella voce, usa la sintassi `{name}`; il suo valore viene inserito nella stringa tradotta senza essere tradotto. I valori possono essere formattati con [ICU message format](https://unicode-org.github.io/icu/userguide/format_parse/messages/).

## Esempi [#examples]

```tsx title="dictionary.ts"
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!', // {username} è una variabile di interpolazione
  },
};

export default dictionary;
```

```tsx title="Component.tsx"
import { useTranslations } from 'gt-react';

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

```tsx title="dictionary.ts"
const dictionary = {
  account: {
    // ICU message format formatta la variabile come Currency
    balance: 'Your account balance: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

```tsx title="Component.tsx"
import { useTranslations } from 'gt-react';

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

## Note [#notes]

* `DictionaryTranslationOptions` si usa con [`useTranslations`](/docs/react/reference/hooks/use-translations) per passare variabili alle voci del dizionario.
* Per le traduzioni inline delle stringhe, vedi [`InlineTranslationOptions`](/docs/react/reference/types/inline-translation-options).
* Consulta la [guida ai dizionari](/docs/react/guides/translating-with-dictionaries) per la configurazione e le convenzioni.