# General Translation Platform: getLocaleDirection
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction.mdx
---

title: getLocaleDirection
description: Restituisce la direzione del testo per un'impostazione regionale. Riferimento API per getLocaleDirection.

---

Determina la direzione del testo di un'impostazione regionale su un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor), utilizzando l'API `Intl.Locale`. General Translation restituisce `'ltr'` per le lingue da sinistra a destra e `'rtl'` per le lingue da destra a sinistra.

## Panoramica [#overview]

Chiama `getLocaleDirection` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale opzionale. Se omesso, viene usato il `targetLocale` dell'istanza.

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'ar' });

const direction = gt.getLocaleDirection('ar');
console.log(direction); // "rtl"

const englishDirection = gt.getLocaleDirection('en-US');
console.log(englishDirection); // "ltr"
```

Firma:

```typescript
getLocaleDirection(locale?: string): 'ltr' | 'rtl'
```

*Nota: `getLocaleDirection` viene eseguito localmente usando `Intl.Locale` e non richiede una chiave API. Usa `targetLocale` dell'istanza quando `locale` viene omesso. Per le ricerche senza un'istanza `GT`, consulta la versione autonoma di [`getLocaleDirection`](/docs/platform/core/reference/utility-functions/locales/get-locale-direction).*

## Come funziona [#how-it-works]

* **Rilevamento della direzione.** Restituisce `'ltr'` per le lingue da sinistra a destra (la maggior parte delle lingue del mondo) e `'rtl'` per le lingue da destra a sinistra (arabo, ebraico, persiano, urdu e altre).
* **Fallback dell'impostazione regionale.** Se `locale` viene omessa, viene usata la `targetLocale` dell'istanza.
* **Impostazione regionale mancante.** Genera un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha una `targetLocale` configurata.

## Parametri [#parameters]

| Parametro           | Descrizione                                                     | Tipo     | Facoltativo | Predefinito         |
| ------------------- | --------------------------------------------------------------- | -------- | ----------- | ------------------- |
| [`locale`](#locale) | Codice locale BCP-47 per cui verificare la direzione del testo. | `string` | Sì          | `this.targetLocale` |

### `locale` [#locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `this.targetLocale`

Codice locale BCP-47 per cui verificare la direzione del testo. Se non viene fornito, viene usato il `targetLocale` dell'istanza.

## Valore restituito [#returns]

**Tipo** `'ltr' | 'rtl'`

La direzione del testo per l'impostazione regionale:

* `'ltr'`: da sinistra a destra (la maggior parte delle lingue).
* `'rtl'`: da destra a sinistra (arabo, ebraico, persiano, urdu, ecc.).

Genera un `Error` se non viene specificata alcuna impostazione regionale e l'istanza non ha un `targetLocale` configurato.

## Esempi [#examples]

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'ar' });

// Controlla le diverse direzioni delle lingue
console.log(gt.getLocaleDirection()); // "rtl" (usa targetLocale 'ar')
console.log(gt.getLocaleDirection('en')); // "ltr"
console.log(gt.getLocaleDirection('ar')); // "rtl"
console.log(gt.getLocaleDirection('he')); // "rtl"
console.log(gt.getLocaleDirection('fa')); // "rtl"
console.log(gt.getLocaleDirection('fr')); // "ltr"
```

## Note [#notes]

* Restituisce `'ltr'` per tutte le lingue da sinistra a destra (la maggior parte delle lingue nel mondo).
* Restituisce `'rtl'` per le lingue da destra a sinistra (arabo, ebraico, persiano, ecc.).