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

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

---

Détermine la direction du texte d’un paramètre régional dans une instance [GT](/docs/platform/core/reference/gt-class/constructor), à l’aide de l’API `Intl.Locale`. General Translation renvoie `'ltr'` pour les langues écrites de gauche à droite et `'rtl'` pour celles écrites de droite à gauche.

## Vue d’ensemble [#overview]

Appelez `getLocaleDirection` sur une instance de [`GT`](/docs/platform/core/reference/gt-class/constructor) avec un code de langue facultatif. S’il n’est pas renseigné, la méthode utilise le `targetLocale` de l’instance.

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

Signature :

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

*Remarque : `getLocaleDirection` s’exécute localement à l’aide de `Intl.Locale` et ne nécessite pas de clé API. Il utilise le `targetLocale` de l’instance lorsque `locale` est omis. Pour les recherches sans instance `GT`, consultez la version autonome de [`getLocaleDirection`](/docs/platform/core/reference/utility-functions/locales/get-locale-direction).*

## Fonctionnement [#how-it-works]

* **Détection de la direction du texte.** Renvoie `'ltr'` pour les langues qui s’écrivent de gauche à droite (la plupart des langues dans le monde) et `'rtl'` pour les langues qui s’écrivent de droite à gauche (arabe, hébreu, persan, ourdou, etc.).
* **Paramètre régional de repli.** Lorsque `locale` n’est pas renseigné, le `targetLocale` de l’instance est utilisé.
* **Paramètre régional manquant.** Lève une `Error` si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré.

## Paramètres [#parameters]

| Paramètre           | Description                                                                                 | Type     | Facultatif | Par défaut          |
| ------------------- | ------------------------------------------------------------------------------------------- | -------- | ---------- | ------------------- |
| [`locale`](#locale) | Code de langue BCP-47 du paramètre régional à utiliser pour vérifier la direction du texte. | `string` | Oui        | `this.targetLocale` |

### `locale` [#locale]

**Type** `string` · **Facultatif** · **Par défaut** `this.targetLocale`

Code de langue BCP-47 dont il faut vérifier la direction du texte. S’il n’est pas fourni, le `targetLocale` de l’instance est utilisé.

## Valeur renvoyée [#returns]

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

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

* `'ltr'` : de gauche à droite (la plupart des langues).
* `'rtl'` : de droite à gauche (arabe, hébreu, persan, ourdou, etc.).

Lance une `Error` si aucun paramètre régional n’est fourni et que l’instance n’a pas de `targetLocale` configuré.

## Exemples [#examples]

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

// Vérifier les différentes directions d'écriture
console.log(gt.getLocaleDirection()); // "rtl" (utilise 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"
```

## Notes [#notes]

* 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.).