# react-native: InlineTranslationOptions
URL: https://generaltranslation.com/it/docs/react-native/api/types/inline-translation-options.mdx
---
title: InlineTranslationOptions
description: Riferimento dell'API per il tipo InlineTranslationOptions
---

{/* GENERATO AUTOMATICAMENTE: Non modificare direttamente. Modifica il template in content/docs-templates/. */}


## Panoramica

Il tipo `InlineTranslationOptions` viene usato per passare variabili alle traduzioni inline e specificarne le modalità di rendering.
Puoi anche aggiungere un contesto e un identificatore alla traduzione.
Viene usato con [`useGT`](/docs/react-native/api/strings/use-gt) e [`msg`](/docs/react-native/api/strings/msg) per passare variabili alle traduzioni inline delle stringhe.

<Callout>
  **Traduzione in fase di build:**
  Le traduzioni con `useGT` e `msg` avvengono in fase di build; tuttavia, le variabili non vengono mai tradotte.
  Vengono invece inserite nella traduzione con la relativa formattazione.
  Assicurati di seguire la [guida al deployment disponibile qui](/docs/react-native/tutorials/quickdeploy).
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
  "variables?": {
      type: 'Record<string, any>',
      optional: true,
      default: 'undefined',
  },
}}
/>

### Descrizione

| Prop        | Descrizione                                                                                                                                                                                       |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `variables` | Un oggetto in cui le chiavi indicano a quale parte della stringa è associato ciascun valore.                                                                                                      |
| `$context`  | Facoltativamente, includi `$context` come variabile nell&#39;oggetto `variables` per fornire contesto al contenuto (usato per la traduzione).                                                     |
| `$id`       | Facoltativamente, includi `$id` come variabile nell&#39;oggetto `variables` per fornire un identificatore da usare con l&#39;editor di traduzione.                                                |
| `$maxChars` | Facoltativamente, includi `$maxChars` come variabile per limitare il numero di caratteri della traduzione. La libreria applica rigorosamente questo limite tramite la logica di `formatCutoff()`. |

***

## Esempi

### Contesto

Per aggiungere contesto alla stringa, utilizziamo la prop `$context`.

```jsx title="Component.tsx"
// [!code word:$context]
import { useGT } from 'gt-react-native';

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


### Passare variabili

Per aggiungere una variabile alla stringa, usiamo la sintassi `{variable-name}`, in cui il nome della variabile è racchiuso tra parentesi graffe.

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

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


### Uso del formato messaggi ICU

`gt-react-native` supporta il formato messaggi ICU, che consente anche di formattare le variabili.

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

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

Per ulteriori informazioni sul formato messaggi ICU, consulta la [documentazione sul formato messaggi ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).

### Limiti di caratteri

Usa `$maxChars` per limitare la lunghezza della traduzione:

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

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

***


## Note

* `InlineTranslationOptions` viene usato per le traduzioni inline delle stringhe.
* L&#39;oggetto `variables` passa i valori al testo.
* L&#39;oggetto `variablesOptions` definisce il comportamento delle variabili.

## Passaggi successivi

* Consulta [`useGT`](/docs/react-native/api/strings/use-gt) per maggiori informazioni sulla traduzione inline delle stringhe.
* Consulta [`formato messaggi ICU`](https://unicode-org.github.io/icu/userguide/format_parse/messages/) per maggiori informazioni sulle opzioni di formattazione.