# gt-next: General Translation Next.js SDK: RuntimeTranslationOptions
URL: https://generaltranslation.com/fr/docs/next/api/types/runtime-translation-options.mdx
---
title: RuntimeTranslationOptions
description: Référence API du type RuntimeTranslationOptions
---

## Vue d’ensemble

Le type `RuntimeTranslationOptions` sert à transmettre des variables aux traductions inline et à définir leur comportement de rendu.
Vous pouvez également ajouter un paramètre régional pour utiliser une autre langue pour la traduction.
Ce type s’utilise avec la fonction [`tx`](/docs/next/api/strings/tx).

<Callout>
  **Traduction runtime :**
  Pour traduire une variable à la demande, incluez-la directement dans la chaîne passée à [`tx`](/docs/next/api/strings/tx).
  Les variables transmises à `tx` via l’objet `options` ne sont pas traduites.
</Callout>

## Référence

### Paramètres

<TypeTable
  type={{
  "[variable]?": {
      type: 'any',
      optional: true,
      default: 'undefined',
  },
  "$locale?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
  "$context?": {
      type: 'string',
      optional: true,
      default: 'undefined',
  },
  "$maxChars?": {
      type: 'number',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Description

| Prop         | Description                                                                                                                                                                    |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `[variable]` | Les variables sont transmises comme clés de premier niveau dans l’objet d’options. Les noms des clés correspondent aux espaces réservés dans la chaîne (par ex. `{username}`). |
| `$locale`    | Spécifiez un paramètre régional pour la traduction. Par défaut, le paramètre régional préféré du navigateur pris en charge par votre application sera utilisé.                 |
| `$maxChars`  | Limitez le nombre de caractères de la traduction. La bibliothèque applique strictement cette limite.                                                                           |

***

## Exemples

### Passage de variables

Pour ajouter une variable à la chaîne, utilisez la syntaxe `{variable-name}`, où le nom de la variable est entouré d’accolades.

```jsx title="Component.tsx"
// [!code word:username]
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>
    {tx(`Hello, {username}!`,{ username: 'Brian123' })}
  </div>;
};
```


### Utiliser le format de message ICU

`gt-next` prend en charge le format de message ICU, ce qui vous permet également de formater vos variables.

```jsx title="Component.tsx"
// [!code word:account-balance]
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>
    { tx(
      'Your account balance: {dollars, number, ::currency/USD}!',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};
```


### Traduire des variables

Pour traduire une variable, incluez-la directement dans la chaîne passée à `tx`.

```jsx title="Component.tsx"
import { tx } from 'gt-next/server';

const Component = ({ hairColor }: { hairColor: string }) => {
  return <div>{tx(
    `Hello, {username}! Your haircolor is ${hairColor}`,
    { username: 'Brian123' }
  )}</div>;
};
```

Notez que la variable `hairColor` est traduite, mais que `username` ne l’est pas.


### Spécifier un paramètre régional

Vous pouvez définir le paramètre régional à utiliser pour la traduction.

```jsx title="Component.tsx"
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>{tx('Hello, world!', { $locale: 'fr' })}</div>;
};
```

Ce sera toujours traduit en français.

### Limites de caractères

Utilisez `$maxChars` pour limiter la longueur de la traduction :

```jsx title="Component.tsx"
// [!code word:$maxChars]
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>{tx('Welcome to our application', { $maxChars: 15 })}</div>;
  // Output: "Bienvenue à no\u202F…"
};
```

***


## Remarques

* `RuntimeTranslationOptions` est utilisé pour les traductions de chaînes en runtime.
* Les variables sont transmises comme clés de premier niveau dans l’objet d’options, et non imbriquées sous une clé `variables`.

## Étapes suivantes

* Consultez [`tx`](/docs/next/api/strings/tx) pour en savoir plus sur la traduction de chaînes inline.
* Consultez le [`format de message ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) pour en savoir plus sur les options de mise en forme.