# react-native: useGT
URL: https://generaltranslation.com/es/docs/react-native/api/strings/use-gt.mdx
---
title: useGT
description: Referencia de la API de la función useGT para traducir cadenas
---

{/* GENERADO AUTOMÁTICAMENTE: No editar directamente. En su lugar, edita la plantilla en content/docs-templates/. */}


## Resumen

La función `useGT` es un hook para traducir cadenas en tiempo de compilación.

```jsx
const gt = useGT();

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

<Callout>
  **Traducción en tiempo de compilación:** las traducciones con `useGT` se realizan en tiempo de compilación, antes de
  que se despliegue tu aplicación. Aunque puedes pasar variables a la cadena traducida, solo
  puedes traducir contenido conocido en tiempo de compilación.
</Callout>


## Referencia

### Parámetros

Ninguno

### Devuelve

Una función callback, `gt`, que traduce el contenido dado.

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

| Nombre     | Tipo                                                                                  | Descripción                                                         |
| ---------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| `content`  | `string`                                                                              | La cadena que se va a traducir.                                     |
| `options?` | [`InlineTranslationOptions`](/docs/react-native/api/types/inline-translation-options) | Opciones de traducción para personalizar el comportamiento de `gt`. |

***


## Comportamiento

### Producción

Durante el proceso de CD, cualquier contenido dentro de una función `gt` se traducirá antes de desplegar tu aplicación.
Esto garantiza tiempos de carga rápidos para todos los locales, pero solo puede traducir contenido conocido en tiempo de compilación.

Una vez generadas, las traducciones se almacenan en (1) la CDN o (2) la salida de compilación de tu aplicación, según tu configuración.
A partir de ahí, el contenido traducido se sirve a tus usuarios.
Si no se encuentra una traducción, se usará el contenido original como alternativa.

Asegúrate de seguir la [guía de despliegue aquí](/docs/react-native/tutorials/quickdeploy).

### Desarrollo

Durante el desarrollo, la función `gt` traducirá el contenido bajo demanda.
Esto resulta útil para probar cómo se verá tu aplicación en diferentes idiomas.
Recuerda añadir una clave API de desarrollo a tu entorno para habilitar este comportamiento.

Verás una demora durante la traducción bajo demanda en desarrollo.
Esto no ocurrirá en las compilaciones de producción, a menos que el contenido se traduzca explícitamente bajo demanda.

***

## Ejemplo

### Uso básico

Puedes usar `useGT` para traducir cadenas.

```jsx copy
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, Alice!')}</p>;
}
```

Nota: &quot;Alice&quot; se traducirá al idioma preferido del usuario.

### Uso de variables [#variables]

Puedes pasar variables a las traducciones del diccionario.

```jsx copy
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, {name}!', { name: 'Alice' })}</p>;
}
```

Nota: &quot;Alice&quot; no se traducirá al idioma preferido del usuario, ya que es una variable.


### Uso del formato de mensajes ICU

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

```jsx copy
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  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>
  );
}
```

<Callout>
  El formato de mensajes ICU es una forma eficaz de dar formato a tus variables. Para obtener más
  información, consulta la [documentación del formato de mensajes
  ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>


### Importar desde `gt-react-native`

Si usas la directiva `"use client"`, debes importar desde `gt-react-native` en lugar de `gt-react-native`.

```jsx copy
'use client';
import { useGT } from 'gt-react-native';

export default function TranslateGreeting() {
  const gt = useGT();

  return <p>{gt('Hello, Alice!')}</p>;
}
```

***


## Notas

* La función `useGT` es un hook que traduce cadenas.
* La traducción de cadenas con `useGT` ocurre antes del tiempo de ejecución, durante el proceso de compilación (salvo en desarrollo).