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

title: getLocaleDirection
description: Renvoie la direction du texte pour un paramètre régional sans instance GT. Référence de l’API pour getLocaleDirection.

---

[`getLocaleDirection`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction) est une fonction utilitaire autonome de la bibliothèque Core de General Translation qui renvoie la direction du texte — de gauche à droite ou de droite à gauche — pour un paramètre régional. Elle est le plus souvent utilisée pour définir l’attribut `dir` d’un élément HTML en fonction du paramètre régional.

## Vue d’ensemble [#overview]

Importez `getLocaleDirection` directement depuis `generaltranslation` et appelez cette fonction avec un code de langue. Elle ne nécessite ni clé API ni instance [GT](/docs/platform/core/reference/gt-class/constructor). Pour l’équivalent fondé sur une instance, utilisez plutôt la méthode [`getLocaleDirection`](/docs/platform/core/reference/gt-class-methods/locales/get-locale-direction) d’une instance [`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"
```

Signature :

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

## Fonctionnement [#how-it-works]

La fonction utilise la propriété `textInfo.direction` de l’API `Intl.Locale` :

1. Crée un objet `Intl.Locale` pour le paramètre régional fourni.
2. Lit la propriété `textInfo.direction` pour déterminer la direction propre à la langue.
3. Renvoie `'rtl'` pour les langues qui s’écrivent de droite à gauche et `'ltr'` pour toutes les autres.
4. Utilise `'ltr'` par défaut si le paramètre régional n’est pas valide ou provoque une erreur.

### Détection des langues RTL

Détecte automatiquement les langues s’écrivant de droite à gauche, notamment :

* **Arabe** (`ar`, `ar-SA`, `ar-EG`, `ar-AE` et autres)
* **Hébreu** (`he`, `he-IL`)
* **Persan/Farsi** (`fa`, `fa-IR`)
* **Ourdou** (`ur`, `ur-PK`, `ur-IN`)
* **Pachto** (`ps`)
* **Sindhi** (`sd`)
* **Kurde sorani** (`ckb`)
* Et d’autres écritures RTL.

### Gestion des erreurs

* Les codes de langue invalides ou mal formés prennent par défaut la valeur `'ltr'`.
* Aucune exception n'est levée en cas d'entrée invalide.

## Paramètres [#parameters]

| Paramètre           | Description                                                        | Type     | Facultatif | Par défaut |
| ------------------- | ------------------------------------------------------------------ | -------- | ---------- | ---------- |
| [`locale`](#locale) | Code de langue BCP-47 dont on veut vérifier la direction du texte. | `string` | Non        | —          |

### `locale` [#locale]

**Type** `string` · **Obligatoire**

Le code de langue BCP-47 permettant de vérifier la direction du texte.

## Retourne [#returns]

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

La direction du texte pour le paramètre régional :

* `'ltr'` : de gauche à droite (la plupart des langues, notamment l’anglais, l’espagnol, le français, l’allemand, le chinois et le japonais).
* `'rtl'` : de droite à gauche (l’arabe, l’hébreu, le persan, l’ourdou et d’autres langues sémitiques ou du Moyen-Orient).

## Exemples [#examples]

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

// Langues de gauche à droite
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"

// Langues de droite à gauche
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"
```

## Remarques [#notes]

* Renvoie `'ltr'` pour toutes les langues qui s’écrivent de gauche à droite (la plupart des langues du monde).
* Renvoie `'rtl'` pour les langues qui s’écrivent de droite à gauche (arabe, hébreu, persan, entre autres).
* Utilise l’API moderne `Intl.Locale` pour une détection précise.
* Fonctionne avec tous les codes de langue BCP-47.