# vue: t
URL: https://generaltranslation.com/es/docs/vue/reference/functions/t.mdx
---

title: t
description: Traduce de forma síncrona una cadena simple desde el runtime de SPA inicializado en el navegador. Referencia de la API de t.

---

Usa `t` para constantes y otras cadenas que se evalúan fuera de los componentes de Vue en una aplicación de una sola página que se ejecuta únicamente en el navegador. El código de los componentes normalmente usa en su lugar el callback reactivo [`useGT()`](/docs/vue/reference/composables/use-gt).

## Descripción general [#overview]

```ts
const t: GTFunction;
```

La función lee el catálogo precargado mediante [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa):

```ts title="src/navigation.ts"
import { t } from 'gt-vue';

export const navigation = [
  t('Documentation', { $context: 'primary navigation' }),
  t('Account settings'),
];
```

Usa cadenas de origen literales y un `$context` literal para que la CLI pueda extraer la misma entrada del catálogo que el runtime calcula mediante hash.

## Parámetros [#parameters]

| Parámetro | Descripción                                                                   | Tipo                                                             | Opcional | Predeterminado |
| --------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------- | -------- | -------------- |
| `message` | Cadena de origen estática para traducir. Las llaves se interpretan literalmente. | `string`                                                         | No       | —              |
| `options` | Contexto utilizado para desambiguar el hash del catálogo.                     | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Sí       | `{}`           |

`$context` es la única opción compatible. `t` no acepta variables de interpolación, `$format`, `$maxChars` ni `$requiresReview`.

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

`t` calcula el hash del catálogo `STRING` sin formato a partir de `message` y `$context`, y luego lee de forma síncrona el catálogo SPA activo. Devuelve la cadena de origen cuando no se encuentra el hash o el valor del catálogo no es una cadena.

El resultado es una instantánea generada al ejecutarse la llamada. Una constante de nivel de módulo no participa en la reactividad de Vue. Por lo tanto, los cambios de configuración regional de la SPA recargan el documento, vuelven a ejecutar el arranque, precargan el nuevo catálogo y vuelven a evaluar el módulo.

Esta API solo realiza búsquedas literales de cadenas:

* Las llaves como `{name}` son caracteres normales.
* La sintaxis ICU no se analiza ni se formatea.
* Los valores de Runtime no se interpolan.
* No se admite la sintaxis de plantillas etiquetadas como `` t`Hello` ``.

Use [`<T>`](/docs/vue/reference/components/t) con [`<Var>`](/docs/vue/reference/components/var) para contenido traducible que contenga valores de Runtime.

## Valor de retorno [#returns]

**Tipo** `string`

Devuelve la traducción de cadena correspondiente o `message` si no existe ninguna traducción de cadena.

## Errores [#failures]

`t` lanza una excepción en cualquiera de estos casos:

* Se ejecuta en el servidor, donde el estado global de traducción del navegador podría filtrarse entre solicitudes.
* Se ejecuta en el navegador antes de que [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa) haya finalizado.

Espere a que se complete la inicialización en un módulo de arranque y, después, importe dinámicamente los módulos que llaman a `t`. Para el renderizado en el servidor, configure el estado de [`createGT({ locale })`](/docs/vue/reference/functions/create-gt#server-rendering) con ámbito de solicitud y traduzca desde un componente con [`useGT()`](/docs/vue/reference/composables/use-gt).

## Ejemplo [#example]

```ts title="src/status.ts"
import { t } from 'gt-vue';

export const STATUS_LABELS = {
  draft: t('Draft', { $context: 'document status' }),
  published: t('Published', { $context: 'document status' }),
};
```

El extractor registra ambas llamadas. Cuando el catálogo activo no está disponible o no contiene ninguna de las dos entradas, los valores son `"Draft"` y `"Published"`.