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

title: DictionaryTranslationOptions
description: Opciones para pasar variables a las entradas del diccionario con General Translation gt-react. Referencia de la API de DictionaryTranslationOptions.

---

`DictionaryTranslationOptions` es el objeto de opciones para las búsquedas en el diccionario. Contiene las variables de interpolación que se insertan en una entrada del diccionario. La acepta la función que devuelve [`useTranslations`](/docs/react/reference/hooks/use-translations).

*Estas opciones se aplican en cualquier entorno donde [`useTranslations`](/docs/react/reference/hooks/use-translations) esté disponible: `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`.*

## Descripción general [#overview]

Pasa las variables de interpolación como claves simples. Cada clave corresponde a un marcador de posición `{name}` en la entrada del diccionario.

```typescript
type DictionaryTranslationOptions = {
  [variable: string]: unknown; // variables de interpolación
};
```

*Nota: en `gt-react` v11, el argumento `options` de `useTranslations` está tipado como `TranslationVariables` (`Record<string, unknown>`); `DictionaryTranslationOptions` es el nombre de referencia de esta estructura. Las variables se insertan en la traducción con formato, pero nunca se traducen por sí mismas.*

## Propiedades [#properties]

| Propiedad                 | Descripción                                                                                                       | Tipo                      |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------- |
| [`variables`](#variables) | Valores de interpolación, con claves correspondientes al nombre del marcador de posición utilizado en la entrada. | `Record<string, unknown>` |

### `variables` [#variables]

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

Cada clave identifica dónde se inserta su valor en la entrada del diccionario. Haz referencia a una variable dentro de la entrada con la sintaxis `{name}`; su valor se inserta en la cadena traducida sin traducir. Los valores pueden formatearse con [formato de mensajes ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).

## Ejemplos [#examples]

```tsx title="dictionary.ts"
const dictionary = {
  greeting: {
    hello: 'Hello, {username}!', // {username} es una variable de interpolación
  },
};

export default dictionary;
```

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

const Component = () => {
  const t = useTranslations();
  // Pasa { username } para rellenar el marcador de posición {username}
  return <div>{t('greeting.hello', { username: 'Brian123' })}</div>;
};
```

```tsx title="dictionary.ts"
const dictionary = {
  account: {
    // el formato de mensajes ICU formatea la variable como 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>;
};
```

## Notas [#notes]

* `DictionaryTranslationOptions` se usa con [`useTranslations`](/docs/react/reference/hooks/use-translations) para pasar variables a las entradas del diccionario.
* Para la traducción de cadenas inline, consulta [`InlineTranslationOptions`](/docs/react/reference/types/inline-translation-options).
* Consulta la [guía de diccionarios](/docs/react/guides/translating-with-dictionaries) para la configuración y las convenciones.