# 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 API para el tipo DictionaryTranslationOptions
---

## Descripción general

El tipo `DictionaryTranslationOptions` se usa para pasar variables a las entradas del diccionario y especificar cómo deben renderizarse.
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 con [`getTranslations`](/docs/next/api/dictionary/get-translations); solo se traduce la cadena original.
  Consulta [`tx`](/docs/next/api/strings/tx) para traducir cadenas con contenido dinámico.
</Callout>

## Referencia

### Parámetros

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

### Descripción

| Prop         | Descripción                                                                                                                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `[variable]` | Las variables se pasan como claves de nivel superior en el objeto de opciones. Los nombres de las claves se corresponden con los marcadores de posición de la entrada del diccionario (por ejemplo, `{username}`). |

***

## Ejemplos

### Pasar variables

Para pasar una variable a una entrada del diccionario, debemos hacer dos cosas: (1) agregar una variable a la entrada y (2) hacer referencia a esa variable en la llamada a [`d`](/docs/next/api/strings/use-gt).

Primero, agregamos 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: 'Hello, {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 formatear 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, hacemos 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

* Las variables se pasan como claves de nivel superior en el objeto de opciones, no dentro de una clave `variables`.

### Próximos pasos

* Consulta [diccionario](/docs/next/guides/dictionaries) para 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 más información sobre la interfaz de diccionarios.
* Consulta [`formato de mensaje ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) para más información sobre las opciones de formato.