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

title: useLocaleDirection
description: Определяет направление текста для локали с помощью General Translation gt-react. Справочник API для useLocaleDirection.

---

Хук `useLocaleDirection` возвращает направление текста — `'ltr'` или `'rtl'` — для текущей локали или локали, которую вы укажете.

*Доступно в `gt-react`, `gt-next` и `gt-react-native`. В примерах используется импорт из `gt-react`; вместо него импортируйте из пакета вашего фреймворка.*

*Примечание: не экспортируется из `gt-tanstack-start`.*

## Обзор [#overview]

Вызовите `useLocaleDirection`, чтобы определить направление текста, и задайте его с помощью атрибута `dir`.

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

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

*Примечание: в `gt-react` вызывайте `useLocaleDirection` внутри [`<GTProvider>`](/docs/react/reference/components/gt-provider). В `gt-next` этот хук также работает в синхронных серверных компонентах.*

## Как это работает [#how-it-works]

При вызове без аргументов хук возвращает направление письма активной локали. Передайте код локали, чтобы получить направление письма для конкретной локали. Это полезно при установке атрибута `dir` для поддержки языков с письмом справа налево.

## Параметры [#parameters]

| Параметр            | Описание                         | Тип      | Необязательный | По умолчанию    |
| ------------------- | -------------------------------- | -------- | -------------- | --------------- |
| [`locale`](#locale) | Локаль, которую нужно проверить. | `string` | Да             | Активная локаль |

### `locale` [#locale]

**Тип** `string` · **Необязательно** · **По умолчанию** Активная локаль

Код локали BCP 47, например `ar` или `en-US`. Если не указано, используется активная локаль из контекста.

## Возвращаемое значение [#returns]

**Тип** `'ltr' | 'rtl'`

Направление текста для данной локали.

## Примеры [#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]

* В асинхронном компоненте App Router вместо этого используйте [`getLocaleDirection`](/docs/react/nextjs/reference/functions/get-locale-direction).
* Полезно для установки атрибута `dir` у элементов, чтобы поддерживать RTL.