# generaltranslation: General Translation Core SDK: getLocaleDirection
URL: https://generaltranslation.com/it/docs/core/functions/locales/get-locale-direction.mdx
---
title: getLocaleDirection
description: Riferimento dell'API per la funzione getLocaleDirection
---

## Panoramica

La funzione `getLocaleDirection` determina la direzione del testo (da sinistra a destra o da destra a sinistra) per un'impostazione regionale senza richiedere un'istanza della classe GT.
Utilizza l'API `Intl.Locale` per rilevare con precisione la direzione di qualsiasi codice locale BCP-47 valido.

Questa funzione viene usata soprattutto per impostare l'attributo `dir` di un elemento HTML in base all'impostazione regionale.

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

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

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

***


## Riferimento

### Parametri

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  }
}}
/>

### Descrizione dei parametri

| Parametro | Descrizione                                                   |
| --------- | ------------------------------------------------------------- |
| `locale`  | Codice locale BCP-47 di cui verificare la direzione del testo |

### Restituisce

`'ltr' | 'rtl'` - Direzione del testo per l&#39;impostazione regionale:

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

***

## Funzionamento

### Algoritmo di rilevamento della direzione

La funzione usa la proprietà `textInfo.direction` dell&#39;API `Intl.Locale`:

1. Crea un oggetto `Intl.Locale` per l&#39;impostazione regionale specificata
2. Accede alla 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. Per impostazione predefinita restituisce `'ltr'` se l&#39;impostazione regionale non è valida o genera un errore

### Riconoscimento delle lingue RTL

Rileva automaticamente le lingue RTL, tra cui:

* **Arabo** (`ar`, `ar-SA`, `ar-EG`, `ar-AE`, ecc.)
* **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'` per impostazione predefinita
* Nessuna eccezione viene generata per input non validi
* Meccanismo di fallback robusto per i casi limite

***

## Esempi

### Rilevamento della direzione di base

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

// Lingue scritte 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 scritte 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

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

## Passaggi successivi

* Usa il metodo [`getLocaleDirection`](/docs/core/class/methods/locales/get-locale-direction) della classe GT
* Ottieni le proprietà dell&#39;impostazione regionale con [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Verifica la validità delle impostazioni regionali con [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)
* Ottieni l&#39;emoji dell&#39;impostazione regionale con [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)