# General Translation React SDKs (gt-react, gt-next, gt-react-native): useLocaleDirection
URL: https://generaltranslation.com/fr/docs/react/reference/hooks/use-locale-direction.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Obtenez la direction du texte d’un paramètre régional. Référence d’API pour useLocaleDirection.

Le hook `useLocaleDirection` vous indique si un paramètre régional s’écrit de gauche à droite (`'ltr'`) ou de droite à gauche (`'rtl'`), en utilisant par défaut le paramètre régional actif lorsque vous n’en indiquez pas.

*Disponible dans `gt-react`, `gt-next` et `gt-react-native`.*

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

## Vue d’ensemble [#overview]

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

*Les exemples importent depuis `gt-react` ; importez plutôt depuis le paquet de votre framework.*

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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.