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

title: InlineTranslationOptions
description: Opciones para pasar variables y metadatos a la traducción de cadenas inline con General Translation gt-react. Referencia de la API de InlineTranslationOptions.

---

`InlineTranslationOptions` es el objeto de opciones para la traducción de cadenas inline. Incluye variables de interpolación y metadatos, como el contexto y un identificador. Lo aceptan [`useGT`](/docs/react/reference/hooks/use-gt) y [`msg`](/docs/react/reference/functions/msg).

*Estas opciones se aplican en cualquier lugar donde estén disponibles [`useGT`](/docs/react/reference/hooks/use-gt) y [`msg`](/docs/react/reference/functions/msg): `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`. El tipo llamado `GTTranslationOptions` se exporta desde `gt-react`, `gt-next` y `gt-react-native`; `gt-tanstack-start` vuelve a exportar las funciones, pero no el tipo.*

## Descripción general [#overview]

Pasa las variables de interpolación como claves simples y los metadatos de traducción mediante claves con el prefijo `$`.

```typescript
type InlineTranslationOptions = {
  [variable: string]: unknown; // variables de interpolación
  $context?: string;
  $id?: string;
  $format?: string;
  $locale?: string;
  $maxChars?: number;
  $requiresReview?: boolean;
};
```

*Nota: en `gt-react` v11, este objeto de opciones corresponde al tipo exportado `GTTranslationOptions`. Las variables se insertan en la traducción, pero nunca se traducen.*

## Propiedades [#properties]

| Propiedad                             | Descripción                                                     | Tipo                      |
| ------------------------------------- | --------------------------------------------------------------- | ------------------------- |
| [`variables`](#variables)             | Valores de interpolación, asignados por nombre.                 | `Record<string, unknown>` |
| [`$context`](#context)                | Contexto de desambiguación para los traductores.                | `string`                  |
| [`$id`](#id)                          | Identificador estable de la entrada para el Translation Editor. | `string`                  |
| [`$format`](#format)                  | Formato de datos del mensaje (p. ej., ICU, STRING).             | `string`                  |
| [`$locale`](#locale)                  | Anula la configuración regional de destino.                     | `string`                  |
| [`$maxChars`](#max-chars)             | Longitud máxima de la traducción.                               | `number`                  |
| [`$requiresReview`](#requires-review) | Requiere aprobación humana antes de usarse.                     | `boolean`                 |

### `variables` [#variables]

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

Cualquier clave que no sea `$` se trata como una variable de interpolación. Haz referencia a ella en la cadena mediante la sintaxis `{name}`; su valor se inserta en la cadena traducida sin traducirlo.

### `$context` [#context]

**Tipo** `string` · **Opcional**

Contexto para precisar la traducción, usado para resolver frases ambiguas.

### `$id` [#id]

**Tipo** `string` · **Opcional**

Un identificador estable de la entrada, que se usa con el Translation Editor.

### `$format` [#format]

**Tipo** `string` · **Opcional** · **Predeterminado** `ICU`

El formato de datos del mensaje (p. ej., ICU, STRING). El valor predeterminado es ICU.

### `$locale` [#locale]

**Tipo** `string` · **Opcional**

Sobrescribe la configuración regional de destino de esta traducción.

### `$maxChars` [#max-chars]

**Tipo** `number` · **Opcional**

Limita la cantidad de caracteres de la traducción. La biblioteca hace cumplir este límite.

### `$requiresReview` [#requires-review]

**Tipo** `boolean` · **Opcional**

Cuando es `true`, marca la traducción para que requiera aprobación humana antes de usarse.

## Ejemplos [#examples]

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

const Component = () => {
  const gt = useGT();
  return <div>{gt('Hello, world!', { $context: 'a formal greeting' })}</div>;
};
```

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

const Component = () => {
  const gt = useGT();
  return <div>{gt('Hello, {username}! How is your day?', { username: 'Brian123' })}</div>;
};
```

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

// El formato de mensajes ICU formatea variables
const Component = () => {
  const gt = useGT();
  return (
    <div>
      {gt('Your account balance: {dollars, number, ::currency/USD}!', { dollars: 1000000 })}
    </div>
  );
};
```

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

const Component = () => {
  const gt = useGT();
  return <div>{gt('Welcome to our application', { $maxChars: 15 })}</div>;
};
```

`gt-react` admite [formato de mensajes ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/) para formatear variables.

## Notas [#notes]

* `InlineTranslationOptions` se usa con [`useGT`](/docs/react/reference/hooks/use-gt) y [`msg`](/docs/react/reference/functions/msg).
* Para búsquedas en diccionarios, consulta [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options).