InlineTranslationOptions
API Reference für den Typ InlineTranslationOptions
Übersicht
Der Typ InlineTranslationOptions wird verwendet, um Variablen an Inline-Übersetzungen zu übergeben und ihr Rendering-Verhalten festzulegen.
Sie können der Übersetzung auch Kontext und eine Kennung hinzufügen.
Er wird mit useGT und msg verwendet, um Variablen an Inline-String-Übersetzungen zu übergeben.
Buildtime Translation:
useGT- und msg-Übersetzungen erfolgen zur Build-Zeit; Variablen werden jedoch niemals übersetzt.
Stattdessen werden sie mit Formatierung in die Übersetzung eingefügt.
Achten Sie darauf, dem Deployment-Leitfaden hier zu folgen.
Referenzen
Parameter
Prop
Type
Beschreibung
| Prop | Beschreibung |
|---|---|
variables | Ein Objekt, in dem die Schlüssel angeben, wohin jeder Wert im String eingefügt bzw. zugeordnet wird. |
$context | Optional $context als Variable im variables-Objekt aufnehmen, um Kontext für den Inhalt bereitzustellen (für die Übersetzung verwendet). |
$id | Optional $id als Variable im variables-Objekt aufnehmen, um eine Kennung für die Verwendung mit dem Übersetzungseditor bereitzustellen. |
Beispiele
Kontext
Um einer Zeichenfolge Kontext hinzuzufügen, verwenden wir das $context-Prop.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>{t('Hallo, Welt!', { $context: 'eine formelle Begrüßung' })}</div>;
};Variablen übergeben
Um einer Zeichenfolge eine Variable hinzuzufügen, verwenden wir die Syntax {variable-name}, wobei geschweifte Klammern den Namen der Variable einschließen.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>{t('Hallo, {username}! Wie läuft dein Tag?', { username: 'Brian123' })}</div>;
};Verwendung des ICU‑Nachrichtenformats
gt-react unterstützt das ICU‑Nachrichtenformat, mit dem Sie auch Variablen formatieren können.
import { useGT } from 'gt-react';
const Component = () => {
const t = useGT();
return <div>
{ t(
'Ihr Kontostand: {dollars, number, ::currency/USD}!',
{
"dollars" : 1000000,
}
) }
</div>;
};Weitere Informationen zum ICU Message Format finden Sie in der Dokumentation zum ICU Message Format.
Hinweise
InlineTranslationOptionswird für Inline-Übersetzungen von Strings verwendet.- Das Objekt
variablesübergibt Werte an den Text. - Das Objekt
variablesOptionslegt das Verhalten der Variablen fest.
Nächste Schritte
- Weitere Informationen zu Inline-String-Übersetzungen finden Sie unter
useGT. - Weitere Informationen zu Formatierungsoptionen finden Sie unter
ICU message format.
Wie ist diese Anleitung?