Überblick

Der Hook useLocale ruft die aktuelle Locale des Nutzers aus dem <GTProvider>-Kontext ab. Die zurückgegebene Locale ist als Zeichenkette formatiert, z. B. 'en-US'.

Referenzen

Rückgabewert

Ein String, der die aktuelle locale des Nutzers repräsentiert, z. B. 'en-US'.

Fallback-Verhalten

Wenn eine nicht unterstützte locale angefordert wird, wird eine Fallback-locale ausgewählt.

Beispielsweise gilt im Fall einer nicht unterstützten locale: Wenn (1) der Nutzer in seinen Browsereinstellungen mehrere bevorzugte locales konfiguriert hat und (2) eine dieser locales von Ihrer Anwendung unterstützt wird, fällt die locale auf die bestmögliche Sprache zurück.

Wenn zudem keine möglichen Fallback-locales verfügbar sind, zwei locales jedoch dieselbe Sprache haben (z. B. en-US und en-GB), fällt die locale auf die unterstützte locale zurück, die dieselbe Sprache hat.

Wenn keine der Bedingungen erfüllt wird, wird die Standard-locale verwendet.

Siehe <GTProvider> für Informationen zur Konfiguration unterstützter locales.

Beispiele

Grundlegende Verwendung

Ermitteln Sie die aktuelle locale und zeigen Sie sie in Ihrer Komponente an.

import { useLocale } from 'gt-react';

export default function CurrentLocale() {
    const locale = useLocale(); 
    return <p>Aktuelle Locale: {locale}</p>;
}

Hinweise

• Der Hook useLocale verwendet den <GTProvider>, um auf den Kontext zuzugreifen. Stellen Sie sicher, dass Ihre App auf Root-Ebene mit einem Provider versehen ist.
• Mehr über Locale-Strings erfahren Sie hier.

Nächste Schritte

• Erfahren Sie, wie Sie die unterstützten locales in Ihrer Anwendung mit der Datei gt.config.json verwalten und festlegen.