# General Translation React SDKs (gt-react, gt-next): useGT
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-gt.mdx
---

title: useGT
description: Obtén una función para traducir cadenas inline con General Translation gt-react. Referencia de la API de useGT.

---

El `hook` `useGT` devuelve una función que traduce cadenas a la configuración regional activa. Úsalo para etiquetas, marcadores de posición y otras cadenas independientes donde [`<T>`](/docs/react/reference/components/t) no encaje.

*Disponible en `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`. Los ejemplos importan desde `gt-react`; en su lugar, importa desde el paquete de tu framework.*

## Resumen [#overview]

Llama a `useGT` para obtener la función de traducción y luego pásale una cadena. La función se devuelve directamente.

```tsx
const gt = useGT();

<p>{gt('This text will be translated')}</p>;
```

*Nota: En `gt-react`, llama a `useGT` dentro de un [`<GTProvider>`](/docs/react/reference/components/gt-provider). En `gt-next`, también funciona en componentes de servidor sincrónicos. Escribe `const gt = useGT()`; el hook devuelve la función directamente, no un objeto.*

## Cómo funciona [#how-it-works]

* **Traducción en tiempo de compilación.** En producción, las cadenas que se pasan a `gt` se traducen durante la compilación, antes del despliegue. Solo se puede traducir el contenido conocido en tiempo de compilación. Si falta una traducción, se usa la cadena original.
* **A demanda en desarrollo.** Con una clave de API de desarrollo, `gt` traduce a demanda para que puedas previsualizar configuraciones regionales, con una ligera demora que no se produce en producción.
* **Las variables no se traducen.** Los valores interpolados se insertan en la cadena traducida, pero nunca se traducen por sí mismos.

## Parámetros [#parameters]

`useGT` no acepta parámetros.

## Returns [#returns]

**Type** `(content: string, options?: InlineTranslationOptions) => string`

Una función que traduce la cadena proporcionada según la configuración regional activa.

| Nombre    | Descripción                                                                 | Type                                                                                 | Opcional |
| --------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------- |
| `content` | El contenido de texto que se va a traducir.                                 | `string`                                                                             | No       |
| `options` | Variables de interpolación y opciones como `$context`, `$id` y `$maxChars`. | [`InlineTranslationOptions`](/docs/react/reference/types/inline-translation-options) | Sí       |

## Ejemplos [#examples]

```tsx
import { useGT } from 'gt-react';

export default function TranslateGreeting() {
  const gt = useGT();
  return <p>{gt('Hello, Alice!')}</p>;
}
// "Hello, Alice!" se traduce a la configuración regional del usuario.
```

```tsx
import { useGT } from 'gt-react';

export default function TranslateGreeting() {
  const gt = useGT();
  return <p>{gt('Hello, {name}!', { name: 'Alice' })}</p>;
}
// "Alice" es una variable y no se traduce.
```

```tsx
import { useGT } from 'gt-react';

export default function ItemCount() {
  const gt = useGT();
  return (
    <p>
      {gt(
        'There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart',
        { count: 10 }
      )}
    </p>
  );
}
```

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

## Notas [#notes]

* `useGT` traduce cadenas; las traducciones se realizan en tiempo de compilación (o a demanda durante el desarrollo).
* En un componente async de App Router, usa [`getGT`](/docs/react/nextjs/reference/functions/get-gt) en su lugar.
* Para búsquedas por `id` basadas en diccionario, usa [`useTranslations`](/docs/react/reference/hooks/use-translations); para registrar cadenas en el ámbito del módulo, usa [`msg`](/docs/react/reference/functions/msg) con [`useMessages`](/docs/react/reference/hooks/use-messages).