Panoramica

La funzione getLocaleDirection determina la direzione del testo (da sinistra a destra o da destra a sinistra) per una lingua/locale senza richiedere un'istanza della classe GT. Utilizza l'API Intl.Locale per fornire un rilevamento accurato della direzione per qualsiasi codice locale BCP‑47 valido.

Questa funzione è usata principalmente per impostare l'attributo dir di un elemento HTML in base al locale.

import { getLocaleDirection } from 'generaltranslation';

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

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

Riferimenti

Parametri

Descrizione dei parametri

Restituisce

'ltr' | 'rtl' - Direzione del testo per la locale:

• 'ltr': Da sinistra a destra (la maggior parte delle lingue, tra cui inglese, spagnolo, francese, tedesco, cinese, giapponese, ecc.)
• 'rtl': Da destra a sinistra (arabo, ebraico, persiano, urdu e altre lingue semitiche/mediorientali)

Comportamento

Algoritmo di rilevamento della direzione

La funzione utilizza la proprietà textInfo.direction dell’API Intl.Locale:

1. Crea un oggetto Intl.Locale per la locale fornita
2. Accede alla proprietà textInfo.direction per ottenere la direzione specifica della lingua
3. Restituisce 'rtl' per le lingue da destra a sinistra, 'ltr' per tutte le altre
4. Predefinisce 'ltr' se la locale non è valida o genera un errore

Riconoscimento delle lingue RTL

Rileva automaticamente le lingue RTL, tra cui:

• Arabo (ar, ar-SA, ar-EG, ar-AE, ecc.)
• Ebraico (he, he-IL)
• Persiano/Farsi (fa, fa-IR)
• Urdu (ur, ur-PK, ur-IN)
• Pashto (ps)
• Sindhi (sd)
• Curdo Sorani (ckb)
• E altri sistemi di scrittura RTL

Gestione degli errori

• I codici di locale non validi o malformati predefiniscono 'ltr'
• Nessuna eccezione generata per input non validi
• Comportamento di fallback robusto per i casi limite

Esempi

Rilevamento della direzione di base

import { getLocaleDirection } from 'generaltranslation';

// Lingue con scrittura da sinistra a destra
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"

// Lingue con scrittura da destra a sinistra
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"

Note

• Restituisce 'ltr' per tutte le lingue con direzione di scrittura da sinistra a destra (la maggior parte delle lingue nel mondo)
• Restituisce 'rtl' per le lingue con direzione da destra a sinistra (arabo, ebraico, persiano, ecc.)
• Utilizza la moderna API Intl.Locale per un rilevamento accurato
• Funziona con tutti i codici di lingua BCP-47

Prossimi passaggi

• Usa il metodo di classe GT getLocaleDirection
• Ottieni le proprietà della locale con getLocaleProperties
• Convalida le locale con isValidLocale
• Ottieni l’emoji della locale con getLocaleEmoji