# vue: GTStringOptions
URL: https://generaltranslation.com/fr/docs/vue/reference/types/gt-string-options.mdx
---
title: GTStringOptions
description: Désambiguïse une recherche dans un catalogue de chaînes de caractères simples à l’aide d’un contexte statique. Référence d’API de GTStringOptions.

---

Cet objet d’options est partagé par [`useGT()`](/docs/vue/reference/composables/use-gt), [`t()`](/docs/vue/reference/functions/t), [`msg()`](/docs/vue/reference/functions/msg) et les appels avec une chaîne brute à [`useMessages()`](/docs/vue/reference/composables/use-messages).

## Vue d’ensemble [#overview]

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

| Propriété              | Description                                                                          | Type     | facultatif | Par défaut |
| ---------------------- | ------------------------------------------------------------------------------------ | -------- | ---------- | ---------- |
| [`$context`](#context) | Distingue les chaînes source identiques lors du calcul de leur hachage de catalogue. | `string` | Oui        | —          |

## `$context` [#context]

**Type** `string` · **Facultatif** · **Par défaut** —

Utilisez le contexte lorsqu’un même texte source nécessite des traductions différentes selon la situation :

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

Le contexte affecte l’identité du catalogue, mais n’est pas affiché. Gardez-le statique dans les appels extraits afin que la CLI et le runtime calculent la même clé.

## Options non prises en charge [#unsupported]

Les recherches Vue sur des simples chaînes de caractères n’acceptent volontairement ni les variables d’interpolation, ni `$format`, `$locale`, `$maxChars` ou `$requiresReview`. Elles n’analysent pas non plus la syntaxe ICU. Les accolades et les autres caractères de formatage de message sont interprétés littéralement.

Pour les valeurs évaluées à l’exécution, utilisez [`<T>`](/docs/vue/reference/components/t) avec [`<Var>`](/docs/vue/reference/components/var). Les métadonnées de traduction enrichies doivent être placées sur [`<T>`](/docs/vue/reference/components/t), et non dans `GTStringOptions`.

## Exemple [#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>
```