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

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

---

[`getLocaleDirection`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction) è una funzione di utilità autonoma della libreria core di General Translation che restituisce la direzione del testo — da sinistra a destra o da destra a sinistra — per un'impostazione regionale. Viene usata soprattutto per impostare l'attributo `dir` di un elemento HTML in base all'impostazione regionale.

## Panoramica [#overview]

Importa `getLocaleDirection` direttamente da `generaltranslation` e chiamalo con un codice locale. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente per istanza, usa invece il metodo [`getLocaleDirection`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction) su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { getLocaleDirection } from 'generaltranslation';

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

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

Firma:

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

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

La funzione usa la proprietà `textInfo.direction` dell'API `Intl.Locale`:

1. Crea un oggetto `Intl.Locale` per l'impostazione regionale specificata.
2. Legge la proprietà `textInfo.direction` per determinare la direzione specifica della lingua.
3. Restituisce `'rtl'` per le lingue scritte da destra a sinistra e `'ltr'` per tutte le altre.
4. Usa `'ltr'` come valore predefinito se l'impostazione regionale non è valida o genera un errore.

### Riconoscimento delle lingue RTL

Rileva automaticamente le lingue con scrittura da destra a sinistra, tra cui:

* **Arabo** (`ar`, `ar-SA`, `ar-EG`, `ar-AE` e altri)
* **Ebraico** (`he`, `he-IL`)
* **Persiano/Farsi** (`fa`, `fa-IR`)
* **Urdu** (`ur`, `ur-PK`, `ur-IN`)
* **Pashto** (`ps`)
* **Sindhi** (`sd`)
* **Curdo sorani** (`ckb`)
* E altri sistemi di scrittura RTL.

### Gestione degli errori

* I codici locale non validi o malformati usano `'ltr'` come valore predefinito.
* Non viene generata alcuna eccezione per input non validi.

## Parametri [#parameters]

| Parametro           | Descrizione                                                 | Tipo     | Facoltativo | Predefinito |
| ------------------- | ----------------------------------------------------------- | -------- | ----------- | ----------- |
| [`locale`](#locale) | Codice locale BCP-47 per verificare la direzione del testo. | `string` | No          | —           |

### `locale` [#locale]

**Tipo** `string` · **Obbligatorio**

Il codice locale BCP-47 di cui verificare la direzione del testo.

## Returns [#returns]

**Type** `'ltr' | 'rtl'`

La direzione del testo per l'impostazione regionale:

* `'ltr'`: da sinistra a destra (la maggior parte delle lingue, tra cui inglese, spagnolo, francese, tedesco, cinese e giapponese).
* `'rtl'`: da destra a sinistra (arabo, ebraico, persiano, urdu e altre lingue semitiche o mediorientali).

## Esempi [#examples]

```typescript
import { getLocaleDirection } from 'generaltranslation';

// Lingue da sinistra a destra
console.log(getLocaleDirection('en-US')); // "ltr"
console.log(getLocaleDirection('es-ES')); // "ltr"
console.log(getLocaleDirection('fr-FR')); // "ltr"
console.log(getLocaleDirection('ja-JP')); // "ltr"
console.log(getLocaleDirection('zh-CN')); // "ltr"

// Lingue da destra a sinistra
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"
```

## Note [#notes]

* Restituisce `'ltr'` per tutte le lingue che si leggono da sinistra a destra (la maggior parte delle lingue del mondo).
* Restituisce `'rtl'` per le lingue che si leggono da destra a sinistra (arabo, ebraico, persiano e altre).
* Usa la moderna API `Intl.Locale` per un rilevamento accurato.
* Funziona con tutti i codici locale BCP-47.