# generaltranslation: General Translation Core SDK: getLocaleDirection
URL: https://generaltranslation.com/ja/docs/core/functions/locales/get-locale-direction.mdx
---
title: getLocaleDirection
description: getLocaleDirection 関数の API リファレンス
---

## 概要

`getLocaleDirection` 関数は、GT クラスのインスタンスがなくても、ロケールのテキスト方向 (左から右または右から左) を判定します。
有効な BCP-47 ロケールコードであれば、`Intl.Locale` API を使用して正確に方向を検出できます。

この関数は主に、ロケールに応じて HTML 要素の `dir` 属性を設定する際に使用されます。

```typescript
import { getLocaleDirection } from 'generaltranslation';

const direction = getLocaleDirection('ar-SA');
console.log(direction); // "rtl"

const englishDirection = getLocaleDirection('en-US');
console.log(englishDirection); // "ltr"
```

***


## リファレンス

### パラメータ

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  }
}}
/>

### パラメータの説明

| パラメータ   | 説明                            |
| -------- | ----------------------------- |
| `locale` | テキスト方向を確認するための BCP-47 ロケールコード |

### 戻り値

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

* `'ltr'`: 左から右 (英語、スペイン語、フランス語、ドイツ語、中国語、日本語など、ほとんどの言語) 
* `'rtl'`: 右から左 (アラビア語、ヘブライ語、ペルシャ語、ウルドゥー語、その他のセム語系・中東の言語) 

***

## 挙動

### 方向判定アルゴリズム

この関数は、`Intl.Locale` API の `textInfo.direction` プロパティを使用します。

1. 指定されたロケールに対する `Intl.Locale` オブジェクトを作成します
2. 言語ごとの文字方向を取得するために `textInfo.direction` プロパティにアクセスします
3. 右から左へ記述する言語では `'rtl'` を返し、それ以外では `'ltr'` を返します
4. ロケールが無効な場合やエラーが発生した場合は、デフォルトで `'ltr'` を返します

### RTL 言語の認識

以下のような RTL 言語を自動的に検出します。

* **アラビア語** (`ar`, `ar-SA`, `ar-EG`, `ar-AE` など)
* **ヘブライ語** (`he`, `he-IL`)
* **ペルシア語／ファルシー語** (`fa`, `fa-IR`)
* **ウルドゥー語** (`ur`, `ur-PK`, `ur-IN`)
* **パシュトー語** (`ps`)
* **シンド語** (`sd`)
* **クルド語 (ソラニー)&#x20;**&#x20;(`ckb`)
* その他の RTL 文字体系

### エラーハンドリング

* 無効または不正な形式のロケールコードは、デフォルトで `'ltr'` になります
* 無効な入力でも例外はスローされません
* エッジケースでも堅牢にフォールバックします

***

## 例

### 基本的な方向の判定

```typescript
import { getLocaleDirection } from 'generaltranslation';

// 左から右に書く言語
console.log(getLocaleDirection('en-US')); // "ltr"
console.log(getLocaleDirection('es-ES')); // "ltr"
console.log(getLocaleDirection('fr-FR')); // "ltr"
console.log(getLocaleDirection('ja-JP')); // "ltr"
console.log(getLocaleDirection('zh-CN')); // "ltr"

// 右から左に書く言語
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"
```

***


## 注記

* 左から右に記述するすべての言語 (世界の大半の言語) で `'ltr'` を返します
* 右から左に記述する言語 (アラビア語、ヘブライ語、ペルシア語など) で `'rtl'` を返します
* 正確な判定のために最新の `Intl.Locale` API を使用します
* すべての BCP-47 ロケールコードに対応しています

## 次のステップ

* GT クラスのメソッド [`getLocaleDirection`](/docs/core/class/methods/locales/get-locale-direction) を使う
* [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties) でロケールのプロパティを取得する
* [`isValidLocale`](/docs/core/functions/locales/is-valid-locale) でロケールが有効か検証する
* [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji) でロケールの絵文字を取得する