# generaltranslation: General Translation Core SDK: getLocaleDirection
URL: https://generaltranslation.com/fr/docs/core/functions/locales/get-locale-direction.mdx
---
title: getLocaleDirection
description: Référence API de la fonction getLocaleDirection
---

## Vue d’ensemble

La fonction `getLocaleDirection` détermine la direction du texte (de gauche à droite ou de droite à gauche) pour un paramètre régional, sans nécessiter d’instance de la classe GT.
Elle s’appuie sur l’API `Intl.Locale` pour détecter avec précision la direction du texte pour tout code de langue BCP-47 valide.

Cette fonction est le plus souvent utilisée pour définir l’attribut `dir` d’un élément HTML en fonction du paramètre régional.

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

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

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

***


## Référence

### Paramètres

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

### Description des paramètres

| Paramètre | Description                                                        |
| --------- | ------------------------------------------------------------------ |
| `locale`  | Code de langue BCP-47 permettant de vérifier la direction du texte |

### Renvoie

`'ltr' | 'rtl'` - 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, le japonais, etc.)
* `'rtl'` : De droite à gauche (arabe, hébreu, persan, ourdou et d’autres langues sémitiques ou du Moyen-Orient)

***

## Fonctionnement

### Algorithme de détection de la direction

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 est invalide ou provoque une erreur

### Reconnaissance des langues RTL

Détecte automatiquement les langues RTL, notamment :

* **Arabe** (`ar`, `ar-SA`, `ar-EG`, `ar-AE`, etc.)
* **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 systèmes d’écriture RTL

### Gestion des erreurs

* Les codes de langue invalides ou mal formés sont définis par défaut sur `'ltr'`
* Aucune exception n&#39;est levée en cas d&#39;entrée invalide
* Comportement de repli robuste dans les cas limites

***

## Exemples

### Détection de la direction de base

```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

* Renvoie `'ltr'` pour toutes les langues écrites de gauche à droite (la plupart des langues dans le monde)
* Renvoie `'rtl'` pour les langues écrites de droite à gauche (arabe, hébreu, persan, etc.)
* Utilise l&#39;API moderne `Intl.Locale` pour une détection fiable
* Fonctionne avec tous les codes de langue BCP-47

## Étapes suivantes

* Utilisez la méthode de la classe GT [`getLocaleDirection`](/docs/core/class/methods/locales/get-locale-direction)
* Récupérez les propriétés du paramètre régional avec [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Validez les paramètres régionaux avec [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)
* Récupérez l’emoji du paramètre régional avec [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)