Types

RuntimeTranslationOptions

API Reference für den Typ „RuntimeTranslationOptions“

Übersicht

Der Typ RuntimeTranslationOptions wird verwendet, um variables an Inline-Übersetzungen zu übergeben und ihr Rendering-Verhalten festzulegen. Sie können außerdem eine locale hinzufügen, um eine andere Sprache für die Übersetzung anzugeben. Dies wird mit der Funktion tx verwendet.

Laufzeitübersetzung: Um eine Variable bei Bedarf zu übersetzen, fügen Sie sie direkt in den an tx übergebenen String ein. Über das options-Objekt an tx übergebene variables werden nicht übersetzt.

Referenzen

Parameter

Prop

Type

Beschreibung

PropBeschreibung
variablesEin Objekt, in dem die Schlüssel angeben, an welche Stelle in der Zeichenfolge die jeweiligen Werte eingefügt werden.
$localeSie können optional $locale als Variable im variables-Objekt angeben, um eine locale für die Übersetzung festzulegen. Standardmäßig wird die vom Browser bevorzugte, von Ihrer App unterstützte locale verwendet.

Beispiele

Variablen übergeben

Um eine Variable in einen String einzufügen, verwenden wir die {variable-name}-Syntax, bei der geschweifte Klammern den Variablennamen einschließen.

Component.tsx
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>
    {tx(`Hallo, {username}!`,{ username: 'Brian123' })}
  </div>;
};

Verwendung des ICU Message Format

gt-next unterstützt das ICU Message Format, mit dem Sie auch Ihre variables formatieren können.

Component.tsx
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>
    { tx(
      'Ihr Kontostand: {dollars, number, ::currency/USD}!',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};

Variablen übersetzen

Um eine Variable zu übersetzen, fügen Sie sie direkt in den an tx übergebenen String ein.

Component.tsx
import { tx } from 'gt-next/server';

const Component = ({ hairColor }: { hairColor: string }) => {
  return <div>{tx(
    `Hallo, {username}! Deine Haarfarbe ist ${hairColor}`,
    { username: 'Brian123' }
  )}</div>;
};

Beachte, dass die Variable hairColor übersetzt wird, username jedoch nicht.

Eine locale festlegen

Sie können eine locale angeben, die für die Übersetzung verwendet wird.

Component.tsx
import { tx } from 'gt-next/server';

const Component = () => {
  return <div>{tx('Hallo, Welt!', { $locale: 'fr' })}</div>;
};

Dies wird immer ins Französische übersetzt.


Hinweise

  • RuntimeTranslationOptions wird für Zeichenkettenübersetzungen zur Laufzeit verwendet.
  • Das Objekt variables übergibt Werte an den Text.
  • Das Objekt variablesOptions definiert das Verhalten der Variablen.

Nächste Schritte

  • Siehe tx für weitere Informationen zu Inline-String-Übersetzungen.
  • Siehe ICU message format für weitere Informationen zu Formatierungsoptionen.

Wie ist dieser Leitfaden?

RuntimeTranslationOptions