Übersicht

Die Funktion getLocaleDirection bestimmt die Textausrichtung (von links nach rechts oder von rechts nach links) für eine Locale, ohne dass eine Instanz der GT-Klasse erforderlich ist. Sie verwendet die Intl.Locale‑API, um eine präzise Erkennung der Schreibrichtung für jeden gültigen BCP‑47‑Locale-Code bereitzustellen.

Diese Funktion wird meist genutzt, um das dir‑Attribut eines HTML-Elements anhand der Locale festzulegen.

import { getLocaleDirection } from 'generaltranslation';

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

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

Referenzen

Parameter

Parameterbeschreibung

Rückgabewert

'ltr' | 'rtl' – Schreibrichtung für die locale:

• 'ltr': Von links nach rechts (die meisten Sprachen, einschließlich Englisch, Spanisch, Französisch, Deutsch, Chinesisch, Japanisch usw.)
• 'rtl': Von rechts nach links (Arabisch, Hebräisch, Persisch, Urdu und andere semitische/nahöstliche Sprachen)

Verhalten

Algorithmus zur Richtungserkennung

Die Funktion nutzt die Eigenschaft textInfo.direction der Intl.Locale‑API:

1. Erstellt ein Intl.Locale‑Objekt für die angegebene locale
2. Greift auf die Eigenschaft textInfo.direction zu, um die sprachspezifische Schreibrichtung zu bestimmen
3. Gibt 'rtl' für Rechts‑nach‑Links‑Sprachen und 'ltr' für alle anderen zurück
4. Fällt auf 'ltr' zurück, wenn die locale ungültig ist oder einen Error verursacht

Erkennung von RTL-Sprachen

Erkennt automatisch RTL-Sprachen, darunter:

• Arabisch (ar, ar-SA, ar-EG, ar-AE usw.)
• Hebräisch (he, he-IL)
• Persisch/Farsi (fa, fa-IR)
• Urdu (ur, ur-PK, ur-IN)
• Paschtu (ps)
• Sindhi (sd)
• Kurdisch (Sorani) (ckb)
• Und andere RTL-Schriften

Fehlerbehandlung

• Ungültige oder fehlerhafte locale codes verwenden standardmäßig 'ltr'
• Für ungültige Eingaben werden keine Ausnahmen ausgelöst
• Robustes Standardwertverhalten für Edge Cases

Beispiele

Grundlegende Richtungserkennung

import { getLocaleDirection } from 'generaltranslation';

// Sprachen mit Schreibrichtung links nach rechts
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"

// Sprachen mit Schreibrichtung rechts nach links
console.log(getLocaleDirection('ar-SA')); // "rtl"
console.log(getLocaleDirection('he-IL')); // "rtl"
console.log(getLocaleDirection('fa-IR')); // "rtl"
console.log(getLocaleDirection('ur-PK')); // "rtl"

Hinweise

• Gibt „ltr“ für alle Sprachen mit Leserichtung von links nach rechts zurück (die meisten Sprachen weltweit)
• Gibt „rtl“ für Sprachen mit Leserichtung von rechts nach links zurück (Arabisch, Hebräisch, Persisch usw.)
• Verwendet die moderne Intl.Locale-API für eine präzise Erkennung
• Funktioniert mit allen BCP‑47-Locale-Codes

Nächste Schritte

• Verwenden Sie die Methode der GT-Klasse getLocaleDirection
• Rufen Sie LocaleProperties mit getLocaleProperties ab
• Validieren Sie locales mit isValidLocale
• Rufen Sie das Locale-Emoji mit getLocaleEmoji ab