# gt-next: General Translation Next.js SDK: useLocaleDirection
URL: https://generaltranslation.com/ja/docs/next/api/helpers/use-locale-direction.mdx
---
title: useLocaleDirection
description: useLocaleDirection フックの API リファレンス
---

{/* 自動生成: 直接編集せず、代わりに content/docs-templates/ 内のテンプレートを編集してください。 */}


## 概要

`useLocaleDirection` フックは、現在の、または指定したロケールのテキスト方向 (`'ltr'` または `'rtl'`) を [`<GTProvider>` コンテキスト](/docs/next/api/components/gtprovider) から取得します。

<Callout>
  `useLocaleDirection` はクライアントサイドのフックであり、*クライアントコンポーネントでのみ使用できます*。
  アプリが [`<GTProvider>`](/docs/next/api/components/gtprovider) でラップされていることを確認してください。
</Callout>

## リファレンス

### パラメーター

| パラメーター   | 型               | 説明                                                                     |
| -------- | --------------- | ---------------------------------------------------------------------- |
| `locale` | `string` (省略可)  | BCP 47 のロケールコード (例: `'ar'`, `'en-US'`) 。省略した場合は、コンテキストの現在のロケールが使用されます。 |

### 戻り値

`'ltr' | 'rtl'` — ロケールのテキスト方向。

***

## 例

### 現在のロケールの書字方向を取得する

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

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


### 特定のロケールの書字方向を取得する

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

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

***


## 注意事項

* このフックは常に同期的に動作します。
* RTL 対応で要素の `dir` 属性を設定する際に便利です。

## 次のステップ