# General Translation React SDKs (gt-react, gt-next): useLocaleDirection
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-locale-direction.mdx
---

title: useLocaleDirection
description: Obtenez la direction du texte d’un paramètre régional avec General Translation gt-react. Référence d’API pour useLocaleDirection.

---

Le hook `useLocaleDirection` renvoie la direction du texte — `'ltr'` ou `'rtl'` — pour le paramètre régional actuel, ou pour un paramètre régional que vous indiquez.

*Disponible dans `gt-react`, `gt-next` et `gt-react-native`. Les exemples importent depuis `gt-react` ; importez plutôt depuis le package de votre framework.*

*Remarque : n’est pas exporté par `gt-tanstack-start`.*

## Vue d’ensemble [#overview]

Appelez `useLocaleDirection` pour récupérer la direction, puis appliquez-la via l’attribut `dir`.

```tsx
import { useLocaleDirection } from 'gt-react';

export default function DirectionWrapper({ children }) {
  const dir = useLocaleDirection(); // [!code highlight]
  return <div dir={dir}>{children}</div>;
}
```

*Remarque : dans `gt-react`, appelez `useLocaleDirection` à l’intérieur d’un [`<GTProvider>`](/docs/react/reference/components/gt-provider). Dans `gt-next`, cela fonctionne également dans les composants serveur synchrones.*

## Fonctionnement [#how-it-works]

Lorsqu’il est appelé sans argument, le hook renvoie la direction du texte du paramètre régional actif. Passez un code de langue pour obtenir la direction du texte d’un paramètre régional donné. Cela est utile pour définir l’attribut `dir` afin de prendre en charge les langues qui s’écrivent de droite à gauche.

## Paramètres [#parameters]

| Paramètre           | Description                       | Type     | Facultatif | Par défaut               |
| ------------------- | --------------------------------- | -------- | ---------- | ------------------------ |
| [`locale`](#locale) | Le paramètre régional à vérifier. | `string` | Oui        | Paramètre régional actif |

### `locale` [#locale]

**Type** `string` · **Facultatif** · **Par défaut** Paramètre régional actif

Un code de langue BCP 47, tel que `ar` ou `en-US`. S&#39;il n&#39;est pas précisé, le paramètre régional actif du contexte est utilisé.

## Valeur de retour [#returns]

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

La direction du texte du paramètre régional.

## Exemples [#examples]

```tsx title="SpecificDirection.tsx"
import { useLocaleDirection } from 'gt-react';

export default function SpecificDirection() {
  const dir = useLocaleDirection('ar'); // 'rtl' [!code highlight]
  return <p>Arabic text direction: {dir}</p>;
}
```

## Notes [#notes]

* Dans un composant App Router asynchrone, utilisez plutôt [`getLocaleDirection`](/docs/react/nextjs/reference/functions/get-locale-direction).
* Utile pour définir l’attribut `dir` sur les éléments afin de prendre en charge les langues RTL.