# vue: GTStringOptions
URL: https://generaltranslation.com/es/docs/vue/reference/types/gt-string-options.mdx
---

title: GTStringOptions
description: Desambigua una búsqueda de catálogo de una cadena simple con contexto estático. Referencia de la API de GTStringOptions.

---

Este objeto de opciones se comparte entre [`useGT()`](/docs/vue/reference/composables/use-gt), [`t()`](/docs/vue/reference/functions/t), [`msg()`](/docs/vue/reference/functions/msg) y las llamadas con cadenas sin procesar a [`useMessages()`](/docs/vue/reference/composables/use-messages).

## Resumen [#overview]

```ts
type GTStringOptions = {
  $context?: string;
};
```

| Propiedad              | Descripción                                                             | Tipo     | Opcional | Predeterminado |
| ---------------------- | ----------------------------------------------------------------------- | -------- | -------- | -------------- |
| [`$context`](#context) | Diferencia cadenas de origen idénticas al calcular su hash de catálogo. | `string` | Sí       | —              |

## `$context` [#context]

**Tipo** `string` · **Opcional** · **Predeterminado** —

Usa contexto cuando un mismo texto de origen requiere traducciones diferentes según la situación:

```ts
gt('Open', { $context: 'button that opens a file' });
gt('Open', { $context: 'adjective for an available store' });
```

El contexto afecta a la identidad del catálogo, pero no se muestra. Manténgalo estático en las llamadas extraídas para que la CLI y el tiempo de ejecución calculen la misma clave.

## Opciones no admitidas [#unsupported]

Las búsquedas de cadenas simples de Vue no aceptan deliberadamente variables de interpolación, `$format`, `$locale`, `$maxChars` ni `$requiresReview`. Tampoco interpretan la sintaxis ICU. Las llaves y otros caracteres de formato de mensajes se tratan como texto literal.

Para valores en tiempo de ejecución, usa [`<T>`](/docs/vue/reference/components/t) con [`<Var>`](/docs/vue/reference/components/var). Los metadatos de traducción enriquecidos deben incluirse en [`<T>`](/docs/vue/reference/components/t), no en `GTStringOptions`.

## Ejemplo [#example]

```vue title="src/AccountStatus.vue"
<script setup lang="ts">
import { useGT } from 'gt-vue';

const gt = useGT();
</script>

<template>
  <span>{{ gt('Active', { $context: 'account status' }) }}</span>
</template>
```