# General Translation React SDKs (gt-react, gt-next, gt-react-native): InlineTranslationOptions
URL: https://generaltranslation.com/es/docs/react/reference/types/inline-translation-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Opciones para pasar variables y metadatos a la traducción de cadenas inline. 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 solicitada para las traducciones generadas.     | `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**

Solicita a las herramientas de traducción un límite máximo de caracteres expresado como un entero positivo. La interpolación de cadenas también aplica un corte en tiempo de ejecución cuando una traducción cargada supera el 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).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.