DictionaryTranslationOptions
API-Referenz für den Typ DictionaryTranslationOptions
Überblick
Der DictionaryTranslationOptions
Typ wird verwendet, um Variablen an Wörterbucheinträge zu übergeben und ihr Render-Verhalten zu spezifizieren.
Er wird mit useTranslations()
und getTranslations()
verwendet, um Variablen an Wörterbucheinträge zu übergeben.
Buildtime Translation:
Variablen werden nicht mit useTranslations()
und getTranslations()
übersetzt, nur der ursprüngliche String.
Siehe tx()
für die Übersetzung von Strings mit dynamischem Inhalt.
Referenz
Parameter
Prop | Type | Default |
---|---|---|
variables?? | Record<string, any> | undefined |
Beschreibung
Prop | Beschreibung |
---|---|
variables | Ein Objekt, bei dem die Schlüssel identifizieren, wo jeder Wert im Wörterbucheintrag zugeordnet wird. |
Beispiele
Variablen übergeben
Um eine Variable an den Wörterbucheintrag zu übergeben, müssen wir zwei Dinge tun: (1) eine Variable zum Eintrag hinzufügen und (2) diese Variable im d()
Aufruf referenzieren.
Zuerst fügen wir eine Variable zum Wörterbucheintrag mit der folgenden Syntax hinzu: {username}
.
username
ist der Name der Variable.
const dictionary = {
greeting: {
hello: 'Hallo, {username}!',
},
};
export default dictionary;
Als nächstes referenzieren wir die Variable:
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};
ICU-Nachrichtenformat verwenden
gt-next
unterstützt das ICU-Nachrichtenformat, das es Ihnen ermöglicht, Ihre Variablen auch zu formatieren.
const dictionary = {
account: {
balance: 'Ihr Kontostand: {dollars, number, ::currency/USD}!',
},
};
export default dictionary;
Als nächstes referenzieren wir die Variable:
import { useTranslations } from 'gt-next';
const Component = () => {
const d = useTranslations();
return <div>
{ d(
'account.balance',
{
"dollars" : 1000000,
}
) }
</div>;
};
Notizen
- Das
variables
Objekt übergibt Werte an einen Wörterbucheintrag. - Das
variablesOptions
Objekt definiert das Verhalten der Variablen.
Nächste Schritte
- Siehe dictionaries für weitere Informationen zu Wörterbüchern und bewährten Praktiken.
- Siehe
useTranslations()
odergetTranslations()
für weitere Informationen zur Wörterbuch-Schnittstelle. - Siehe
ICU message format
für weitere Informationen zu Formatierungsoptionen.
Wie ist dieser Leitfaden?