Types

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

PropBeschreibung
variablesEin Objekt, in dem die Schlüssel angeben, wohin jeder Wert im String eingefügt bzw. zugeordnet wird.
$contextOptional $context als Variable im variables-Objekt aufnehmen, um Kontext für den Inhalt bereitzustellen (für die Übersetzung verwendet).
$idOptional $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.

Component.tsx
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.

Component.tsx
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.

Component.tsx
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

  • InlineTranslationOptions wird für Inline-Übersetzungen von Strings verwendet.
  • Das Objekt variables übergibt Werte an den Text.
  • Das Objekt variablesOptions legt 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?