tx()

Überblick

Die tx() Funktion ist eine serverseitige Funktion zum Übersetzen von Zeichenfolgen.

await tx('Hello, world!'); // returns 'Hola, mundo!'

Referenz

Parameter

Rückgabewerte

Ein Versprechen, das zu einem String aufgelöst wird, der den übersetzten Inhalt enthält, oder den Originalinhalt, wenn keine Übersetzung erforderlich ist.

Verhalten

Die Funktion tx() übersetzt Zeichenfolgen zur Laufzeit. Das bedeutet, dass Übersetzungen live durchgeführt werden, sodass Sie Inhalte übersetzen können, die erst zur Laufzeit bekannt sind. Der Kompromiss besteht darin, dass es eine Verzögerung gibt, während auf das Laden einer bedarfsgesteuerten Übersetzung gewartet wird, was erheblich langsamer ist.

Unser Rat ist, alles, was Sie können, zur Build-Zeit zu übersetzen, indem Sie getGT(), useGT() oder <T> verwenden, und nur bei Bedarf bedarfsgesteuerte Übersetzungen wie tx() und <Tx> zu verwenden.

Stellen Sie sicher, dass Sie der Bereitstellungsanleitung hier folgen.

Beispiel

Grundlegende Verwendung

Sie können tx() verwenden, um Zeichenfolgen zu übersetzen.

import { tx } from 'gt-next/server';
 
export default async function translateGreeting() {
    return await tx("Hello, world!"); 
}

Hinzufügen von Kontext

Sie können die Übersetzung anpassen, indem Sie einen Kontext angeben, der bei der Übersetzung berücksichtigt werden soll.

import { tx } from 'gt-next/server';
 
export default async function TranslateWithOptions() {
    return await tx("Hello, world!", {
        context: 'Übersetze informell'
    });
}

Verwendung von Variablen

Um Werte an Ihre Zeichenfolge zu übergeben, müssen Sie (1) einen Bezeichner zuweisen und (2) den Bezeichner im variables-Feld referenzieren.

import { tx } from 'gt-next/server';
 
export default async function translateWithVariables() {
    return await tx("The cost is {price}", {
        variables: { price : 29.99 },
        variableOptions: { price : { style: 'currency', currency: 'MXN' } }
    });
}

Festlegen einer Sprache

Sie können eine Sprache angeben, die für die Übersetzung verwendet werden soll. Standardmäßig ist die Sprache auf die bevorzugte Sprache des Benutzers eingestellt.

import { tx } from 'gt-next/server';
 
export default async function translateWithLocale() {
    return await tx("Hello, world!", { locale: 'fr' }); 
}

Notizen

• tx() ausschließlich für die serverseitige Nutzung und kann nicht in clientseitigen Komponenten verwendet werden.
• Übersetzungen mit tx() erfolgen zur Laufzeit, was bedeutet, dass sie live übersetzt werden. Dies ist erheblich langsamer als Übersetzungen zur Build-Zeit.

Nächste Schritte

• Siehe useGT() und getGT() für die Übersetzung von Strings vor der Bereitstellung.
• Für die Übersetzung von jsx, siehe <T> und <Tx>.
• Siehe RuntimeTranslationOptions für weitere Informationen zur Anpassung von Übersetzungen.