# gt-react: General Translation React SDK: useLocaleDirection
URL: https://generaltranslation.com/fr/docs/react/api/helpers/use-locale-direction.mdx
---
title: useLocaleDirection
description: Référence de l’API du hook useLocaleDirection
---

{/* GÉNÉRÉ AUTOMATIQUEMENT : ne modifiez pas ce fichier directement. Modifiez plutôt le modèle dans content/docs-templates/. */}


## Vue d’ensemble

Le hook `useLocaleDirection` récupère la direction du texte (`'ltr'` ou `'rtl'`) pour le paramètre régional actuel ou pour un paramètre régional spécifié depuis le [contexte `<GTProvider>`](/docs/react/api/components/gtprovider).

<Callout>
  `useLocaleDirection` est un hook côté client et *ne peut être utilisé que dans des composants côté client*.
  Assurez-vous que votre application est bien encapsulée dans un [`<GTProvider>`](/docs/react/api/components/gtprovider).
</Callout>

## Référence

### Paramètres

| Paramètre | Type                  | Description                                                                                                                                    |
| --------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `locale`  | `string` (facultatif) | Un code de langue BCP 47 (par ex. `'ar'`, `'en-US'`). S&#39;il n&#39;est pas renseigné, le paramètre régional courant du contexte est utilisé. |

### Retourne

`'ltr' | 'rtl'` — La direction du texte du paramètre régional.

***

## Exemples

### Obtenir la direction du texte du paramètre régional actuel

```jsx title="DirectionWrapper.jsx" copy
'use client';
import { useLocaleDirection } from 'gt-react';

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


### Obtenir la direction du texte d’un paramètre régional donné

```jsx title="SpecificDirection.jsx" copy
'use client';
import { useLocaleDirection } from 'gt-react';

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

***


## Remarques

* Ce hook est toujours synchrone.
* Utile pour définir l’attribut `dir` sur les éléments afin de prendre en charge les langues RTL.

## Étapes suivantes