# gt-next: General Translation Next.js SDK: DictionaryTranslationOptions
URL: https://generaltranslation.com/es/docs/next/api/types/dictionary-translation-options.mdx
---
title: DictionaryTranslationOptions
description: Referencia de la API para el tipo DictionaryTranslationOptions
---

## resumen

El tipo `DictionaryTranslationOptions` se usa para pasar variables a las entradas del diccionario y especificar su comportamiento de renderizado.
Se usa con [`useTranslations`](/docs/next/api/dictionary/use-translations) y [`getTranslations`](/docs/next/api/dictionary/get-translations) para pasar variables a las entradas del diccionario.

<Callout>
  **Traducción en tiempo de compilación:**
  Las variables no se traducen con [`useTranslations`](/docs/next/api/dictionary/use-translations) ni [`getTranslations`](/docs/next/api/dictionary/get-translations); solo se traduce la cadena original.
  Consultar [`tx`](/docs/next/api/strings/tx) para traducir cadenas con contenido dinámico.
</Callout>

## Referencia

### Parámetros

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

### Descripción

| Prop        | Descripción                                                                                  |
| ----------- | -------------------------------------------------------------------------------------------- |
| `variables` | Un objeto cuyas claves identifican dónde se asigna cada valor en la entrada del diccionario. |

***

## Ejemplos

### Pasar variables

Para pasar una variable a una entrada del diccionario, hay que hacer dos cosas: (1) añadir una variable a la entrada y (2) hacer referencia a esa variable en la invocación de [`d`](/docs/next/api/strings/use-gt).

Primero, añadimos una variable a la entrada del diccionario con la siguiente sintaxis: `{username}`.
`username` es el nombre de la variable.

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

export default dictionary;
```

A continuación, hacemos referencia a la variable:

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


### Uso del formato de mensajes ICU

`gt-next` admite el formato de mensajes ICU, lo que también te permite dar formato a las variables.

```jsx title="dictionary.ts"
// [!code word:account-balance]
const dictionary = {
  account: {
    balance: 'El saldo de tu cuenta: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;
```

A continuación, se hace referencia a la variable:

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

***


## Notas

* El objeto `variables` pasa valores a una entrada del diccionario.
* El objeto `variablesOptions` define el comportamiento de las variables.

### Siguientes pasos

* Consulta [diccionarios](/docs/next/guides/dictionaries) para obtener más información sobre los diccionarios y las prácticas habituales.
* Consulta [`useTranslations`](/docs/next/api/dictionary/use-translations) o [`getTranslations`](/docs/next/api/dictionary/get-translations) para obtener más información sobre la interfaz de los diccionarios.
* Consulta [`formato de mensajes ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) para obtener más información sobre las opciones de formato.