# 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 el template en content/docs-templates/. */}


## Descripción general

La función `useGT` es un Hook para traducir cadenas durante el tiempo de construcción.

```jsx
const gt = useGT();

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

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


## Referencia

### Parámetros

Ninguno

### Devuelve

Una función de devolución de llamada, `gt`, que traduce el contenido proporcionado.

```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`. |

***


## Funcionamiento

### 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 todas las configuraciones regionales, pero solo puede traducir contenido que se conozca en tiempo de construcción.

Una vez generadas, las traducciones se almacenan (1) en la CDN o (2) en el resultado 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.

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 on-demand.
Esto resulta útil para crear prototipos de cómo se verá tu aplicación en distintos idiomas.
Recuerda añadir una API key de desarrollo a tu entorno para habilitar este comportamiento.

Verás una demora durante la traducción on-demand en desarrollo.
Esto no ocurrirá en las compilaciones de producción, a menos que el contenido se esté traduciendo explícitamente on-demand.

***

## 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 que prefiera el 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 porque es una variable.


### Uso del formato de mensaje ICU

`gt-react-native` admite el formato de mensaje ICU, que también te permite formatear tus 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 mensaje ICU es una forma eficaz de dar formato a las variables. Para obtener más
  información, consulta la [documentación sobre el formato de mensaje
  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.
* Las cadenas traducidas con `useGT` se generan antes del runtime, durante el proceso de compilación (salvo en desarrollo).