# General Translation React SDKs (gt-react, gt-next, gt-react-native): InlineTranslationOptions
URL: https://generaltranslation.com/fr/docs/react/reference/types/inline-translation-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Options pour transmettre des variables et des métadonnées aux traductions de chaîne en ligne. Référence de l’API pour InlineTranslationOptions.

`InlineTranslationOptions` est l’objet d’options pour les traductions de chaîne en ligne. Il contient des variables d’interpolation ainsi que des métadonnées telles que le contexte et un identifiant. Il est accepté par [`useGT`](/docs/react/reference/hooks/use-gt) et [`msg`](/docs/react/reference/functions/msg).

*Ces options s’appliquent partout où [`useGT`](/docs/react/reference/hooks/use-gt) et [`msg`](/docs/react/reference/functions/msg) sont disponibles — `gt-react`, `gt-next`, `gt-tanstack-start` et `gt-react-native`. Le type nommé `GTTranslationOptions` est exporté par `gt-react`, `gt-next` et `gt-react-native` ; `gt-tanstack-start` réexporte les fonctions, mais pas le type.*

## Vue d’ensemble [#overview]

Transmettez les variables d’interpolation sous forme de clés simples, et les métadonnées de traduction avec des clés préfixées par `$`.

```typescript
type InlineTranslationOptions = {
  [variable: string]: unknown; // variables d'interpolation
  $context?: string;
  $id?: string;
  $format?: string;
  $locale?: string;
  $maxChars?: number;
  $requiresReview?: boolean;
};
```

*Remarque : dans `gt-react` v11, cet objet d’options correspond au type exporté `GTTranslationOptions`. Les variables sont insérées dans la traduction, mais ne sont jamais traduites elles-mêmes.*

## Propriétés [#properties]

| Propriété                             | Description                                               | Type                      |
| ------------------------------------- | --------------------------------------------------------- | ------------------------- |
| [`variables`](#variables)             | Valeurs d’interpolation, indexées par nom.                | `Record<string, unknown>` |
| [`$context`](#context)                | Contexte de désambiguïsation pour les traducteurs.        | `string`                  |
| [`$id`](#id)                          | Identifiant d’entrée stable pour le Translation Editor.   | `string`                  |
| [`$format`](#format)                  | Format de données du message (par ex. : ICU, STRING).     | `string`                  |
| [`$locale`](#locale)                  | Remplace le paramètre régional cible.                     | `string`                  |
| [`$maxChars`](#max-chars)             | Longueur maximale demandée pour les traductions générées. | `number`                  |
| [`$requiresReview`](#requires-review) | Exige une approbation humaine avant utilisation.          | `boolean`                 |

### `variables` [#variables]

**Type** `Record<string, unknown>`

Toute clé autre que celles commençant par `$` est traitée comme une variable d’interpolation. Référencez-la dans la chaîne à l’aide de la syntaxe `{name}` ; sa valeur est insérée dans la chaîne traduite sans être elle-même traduite.

### `$context` [#context]

**Type** `string` · **Facultatif**

Contexte permettant d’affiner la traduction et de lever les ambiguïtés.

### `$id` [#id]

**Type** `string` · **Facultatif**

Identifiant stable de l’entrée, utilisé avec le Translation Editor.

### `$format` [#format]

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

Le format du message (par ex. : ICU, STRING). La valeur par défaut est ICU.

### `$locale` [#locale]

**Type** `string` · **Facultatif**

Remplace le paramètre régional cible de cette traduction.

### `$maxChars` [#max-chars]

**Type** `number` · **Facultatif**

Indique aux outils de traduction un nombre maximal de caractères entier positif. L’interpolation de chaînes applique également une troncature à l’exécution lorsqu’une traduction chargée dépasse cette limite.

### `$requiresReview` [#requires-review]

**Type** `boolean` · **Facultatif**

Lorsque la valeur est `true`, la traduction doit être approuvée par un humain avant d’être utilisée.

## Exemples [#examples]

```tsx title="Component.tsx"
import { useGT } from 'gt-react';

const Component = () => {
  const gt = useGT();
  return <div>{gt('Hello, world!', { $context: 'a formal greeting' })}</div>;
};
```

```tsx title="Component.tsx"
import { useGT } from 'gt-react';

const Component = () => {
  const gt = useGT();
  return <div>{gt('Hello, {username}! How is your day?', { username: 'Brian123' })}</div>;
};
```

```tsx title="Component.tsx"
import { useGT } from 'gt-react';

// Le format de message ICU permet de formater les variables
const Component = () => {
  const gt = useGT();
  return (
    <div>
      {gt('Your account balance: {dollars, number, ::currency/USD}!', { dollars: 1000000 })}
    </div>
  );
};
```

```tsx title="Component.tsx"
import { useGT } from 'gt-react';

const Component = () => {
  const gt = useGT();
  return <div>{gt('Welcome to our application', { $maxChars: 15 })}</div>;
};
```

`gt-react` prend en charge le [format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/) pour mettre en forme les variables.

## Remarques [#notes]

* `InlineTranslationOptions` s’utilise avec [`useGT`](/docs/react/reference/hooks/use-gt) et [`msg`](/docs/react/reference/functions/msg).
* Pour les recherches dans le dictionnaire, consultez [`DictionaryTranslationOptions`](/docs/react/reference/types/dictionary-translation-options).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.