Types

DictionaryTranslationOptions

API Reference für den Typ DictionaryTranslationOptions

Überblick

Der Typ DictionaryTranslationOptions wird verwendet, um variables an Wörterbuch­einträge zu übergeben und deren Renderverhalten festzulegen. Er wird zusammen mit useTranslations eingesetzt, um variables an Wörterbucheinträge zu übergeben.

Buildtime Translation: useTranslations-Übersetzungen erfolgen zur Build-Zeit; variables werden jedoch niemals übersetzt. Stattdessen werden sie formatiert in die Übersetzung eingesetzt. Achten Sie darauf, der Bereitstellungsanleitung zu folgen.

Referenz

Parameter

Prop

Type

Beschreibung

PropBeschreibung
variablesEin Objekt, dessen Schlüssel angeben, welchem Ziel jeder Wert im Wörterbuch-Entry zugeordnet wird.

Beispiele

Übergabe von Variablen

Um eine Variable an den Wörterbuch-Eintrag zu übergeben, müssen wir zwei Dinge tun: (1) der Entry eine Variable hinzufügen und (2) diese Variable im Aufruf von d referenzieren.

Zuerst fügen wir dem Wörterbuch-Eintrag eine Variable mit der folgenden Syntax hinzu: {username}. username ist der Name der Variable.

dictionary.ts
const dictionary = {
  greeting: {
    hello: 'Hallo, {username}!',
  },
};

export default dictionary;

Als Nächstes referenzieren wir die Variable:

Component.tsx
import { useTranslations } from 'gt-react';

const Component = () => {
  const d = useTranslations();
  return <div>{d('greeting.hello', { username: 'Brian123' })}</div>;
};

Verwendung des ICU Message Format

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

dictionary.ts
const dictionary = {
  account: {
    balance: 'Kontostand: {dollars, number, ::currency/USD}!',
  },
};

export default dictionary;

Als Nächstes beziehen wir uns auf die Variable:

Component.tsx
import { useTranslations } from 'gt-react';

const Component = () => {
  const d = useTranslations();
  return <div>
    { d(
      'account.balance',
      {
        "dollars" : 1000000,
      }
    ) }
  </div>;
};

Hinweise

  • Das Objekt variables übergibt Werte an einen Wörterbuch-Eintrag.
  • Das Objekt variablesOptions definiert das Verhalten der Variablen.

Nächste Schritte

  • Siehe dictionaries für weitere Informationen zu dictionaries und bewährten Praktiken.
  • Siehe useTranslations für weitere Informationen zur dictionaries-API.
  • Siehe ICU message format für weitere Informationen zu Formatierungsoptionen.

Wie ist dieser Leitfaden?

DictionaryTranslationOptions