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

title: useLocaleDirection
description: Leggi la direzione del testo di un'impostazione regionale con General Translation gt-react. Riferimento API per useLocaleDirection.

---

L'hook `useLocaleDirection` restituisce la direzione del testo — `'ltr'` o `'rtl'` — per l'impostazione regionale corrente o per un'impostazione regionale specificata.

*Disponibile in `gt-react`, `gt-next` e `gt-react-native`. Gli esempi importano da `gt-react`; importa invece dal pacchetto del framework che utilizzi.*

*Nota: non esportato da `gt-tanstack-start`.*

## Panoramica [#overview]

Chiama `useLocaleDirection` per ottenere la direzione del testo e applicala con l'attributo `dir`.

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

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

*Nota: in `gt-react`, chiama `useLocaleDirection` all&#39;interno di un [`<GTProvider>`](/docs/react/reference/components/gt-provider). In `gt-next`, funziona anche nei componenti server sincroni.*

## Come funziona [#how-it-works]

Quando viene chiamato senza argomenti, l&#39;hook restituisce la direzione dell&#39;impostazione regionale attiva. Passa un codice locale per ottenere la direzione di un&#39;impostazione regionale specifica. È utile per impostare l&#39;attributo `dir` e supportare le lingue con scrittura da destra a sinistra.

## Parametri [#parameters]

| Parametro           | Descrizione                                 | Tipo     | Facoltativo | Predefinito                   |
| ------------------- | ------------------------------------------- | -------- | ----------- | ----------------------------- |
| [`locale`](#locale) | L&#39;impostazione regionale da verificare. | `string` | Sì          | Impostazione regionale attiva |

### `locale` [#locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** Impostazione regionale attiva

Un codice locale BCP 47, come `ar` o `en-US`. Se omesso, viene usata l&#39;impostazione regionale attiva del contesto.

## Valore restituito [#returns]

**Tipo** `'ltr' | 'rtl'`

La direzione del testo per l&#39;impostazione regionale.

## Esempi [#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>;
}
```

## Note [#notes]

* In un componente asincrono di App Router, usa invece [`getLocaleDirection`](/docs/react/nextjs/reference/functions/get-locale-direction).
* Utile per impostare l&#39;attributo `dir` sugli elementi, così da supportare RTL.