# generaltranslation: General Translation Core SDK: getLocaleDirection
URL: https://generaltranslation.com/es/docs/core/functions/locales/get-locale-direction.mdx
---
title: getLocaleDirection
description: Referencia de la API de la función getLocaleDirection
---

## Resumen

La función `getLocaleDirection` determina la dirección del texto (de izquierda a derecha o de derecha a izquierda) de una configuración regional sin necesidad de una instancia de la clase GT.
Usa la API `Intl.Locale` para detectar con precisión la dirección de cualquier código de configuración regional válido conforme a BCP-47.

Esta función se usa con más frecuencia para establecer el atributo `dir` de un elemento HTML según la configuración regional.

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

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

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

***


## Referencia

### Parámetros

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

### Descripción de los parámetros

| Parámetro | Descripción                                                                   |
| --------- | ----------------------------------------------------------------------------- |
| `locale`  | Código de configuración regional BCP-47 para comprobar la dirección del texto |

### Devuelve

`'ltr' | 'rtl'` - Dirección del texto de la configuración regional:

* `'ltr'`: De izquierda a derecha (la mayoría de los idiomas, incluidos el inglés, el español, el francés, el alemán, el chino, el japonés, etc.)
* `'rtl'`: De derecha a izquierda (árabe, hebreo, persa, urdu y otros idiomas semíticos o de Oriente Medio)

***

## Comportamiento

### Algoritmo de detección de la dirección

La función usa la propiedad `textInfo.direction` de la API `Intl.Locale`:

1. Crea un objeto `Intl.Locale` para la configuración regional proporcionada
2. Accede a la propiedad `textInfo.direction` para obtener la dirección específica del idioma
3. Devuelve `'rtl'` para los idiomas de derecha a izquierda y `'ltr'` para todos los demás
4. Usa `'ltr'` de forma predeterminada si la configuración regional no es válida o produce un error

### Reconocimiento de idiomas RTL

Detecta automáticamente idiomas RTL, incluidos:

* **Árabe** (`ar`, `ar-SA`, `ar-EG`, `ar-AE`, etc.)
* **Hebreo** (`he`, `he-IL`)
* **Persa/Farsi** (`fa`, `fa-IR`)
* **Urdu** (`ur`, `ur-PK`, `ur-IN`)
* **Pastún** (`ps`)
* **Sindhi** (`sd`)
* **Kurdo soraní** (`ckb`)
* Y otros sistemas de escritura RTL

### Manejo de errores

* Los códigos de configuración regional no válidos o mal formados usan `'ltr'` de forma predeterminada
* No se lanzan excepciones ante entradas no válidas
* Comportamiento de alternativa robusto en casos límite

***

## Ejemplos

### Detección básica de dirección

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

// Idiomas de izquierda a derecha
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"

// Idiomas de derecha a izquierda
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"
```

***


## Notas

* Devuelve `'ltr'` para todos los idiomas de izquierda a derecha (la mayoría de los idiomas del mundo)
* Devuelve `'rtl'` para todos los idiomas de derecha a izquierda (árabe, hebreo, persa, etc.)
* Usa la API moderna `Intl.Locale` para detectar con precisión
* Funciona con todos los códigos de configuración regional BCP-47

## Próximos pasos

* Usa el método de la clase GT [`getLocaleDirection`](/docs/core/class/methods/locales/get-locale-direction)
* Obtén las propiedades de la configuración regional con [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)
* Valida locales con [`isValidLocale`](/docs/core/functions/locales/is-valid-locale)
* Obtén el emoji de la configuración regional con [`getLocaleEmoji`](/docs/core/functions/locales/get-locale-emoji)