DictionaryTranslationOptions
API-Referenz für den Typ DictionaryTranslationOptions
Übersicht
Der Typ DictionaryTranslationOptions
wird verwendet, um Variablen an Wörterbucheinträge zu übergeben und ihr Anzeigeverhalten festzulegen.
Er wird zusammen mit useDict()
verwendet, um Variablen an Wörterbucheinträge zu übergeben.
Buildtime-Übersetzung:
useDict()
-Übersetzungen erfolgen zur Buildzeit; jedoch werden Variablen niemals übersetzt.
Stattdessen werden sie mit Formatierung in die Übersetzung eingefügt.
Achten Sie darauf, die Bereitstellungsanleitung hier zu befolgen.
Referenz
Parameter
Prop | Type | Default |
---|---|---|
variablesOptions?? | Record<string, Intl.NumberFormatOptions | Intl.DateTimeFormatOptions> | undefined |
variables?? | Record<string, any> | undefined |
Beschreibung
Prop | Beschreibung |
---|---|
variables | Ein Objekt, bei dem die Schlüssel angeben, wo jeder Wert im Wörterbucheintrag zugeordnet wird. |
variablesOptions | Ein Objekt, bei dem die Schlüssel die Variable identifizieren und die Werte das Verhalten der Variablen definieren. Siehe Intl.NumberFormatOptions und Intl.DateTimeFormatOptions für weitere Informationen. |
Beispiele
Variablen übergeben
Um eine Variable an den Dictionary-Eintrag zu übergeben, müssen wir zwei Dinge tun: (1) eine Variable zum Eintrag hinzufügen und (2) diese Variable im Aufruf von d()
referenzieren.
Zuerst fügen wir dem Dictionary-Eintrag eine Variable mit folgendem Syntax hinzu: {username}
.
username
ist der Name der Variable.
const dictionary = {
greeting: {
hello: 'Hello, {username}!',
},
};
export default dictionary;
Als Nächstes referenzieren wir die Variable:
import { useDict } from 'gt-react';
const Component = () => {
const d = useDict();
return <div>{d('greeting.hello', { variables: { username : 'Brian123' } })}</div>;
};
Variable-Optionen hinzufügen
Mit Variable-Optionen kannst du anpassen, wie eine Variable dargestellt wird.
Es wird die gleiche Syntax wie das variables
-Objekt verwendet.
const dictionary = {
account: {
balance: 'Your account balance: {account-balance}!',
},
};
export default dictionary;
Als Nächstes referenzieren wir die Variable:
import { useDict } from 'gt-react';
const Component = () => {
const d = useDict();
return <div>
{ d(
'account.balance',
{
variables: { "account-balance" : 1000000 },
variableOptions: { "account-balance": { style: 'currency', currency: 'USD' } }
}
) }
</div>;
};
Hinweise
- Das
variables
-Objekt übergibt Werte an einen Wörterbucheintrag. - Das
variablesOptions
-Objekt definiert das Verhalten der Variablen.
Nächste Schritte
- Siehe Wörterbücher für weitere Informationen zu Wörterbüchern und gängigen Praktiken.
- Siehe
useDict()
für weitere Informationen zur Wörterbuchschnittstelle. - Siehe
Intl.NumberFormatOptions
undIntl.DateTimeFormatOptions
für weitere Informationen zu Formatierungsoptionen.
Wie ist dieser Leitfaden?