Types

DictionaryTranslationOptions

API Reference für den Typ DictionaryTranslationOptions

Übersicht

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

Buildtime Translation: Variables werden mit useTranslations und getTranslations nicht übersetzt — nur der ursprüngliche String. Siehe tx zum Übersetzen von Strings mit dynamischem Inhalt.

Referenzen

Parameter

Prop

Type

Beschreibung

PropBeschreibung
variablesEin Objekt, dessen Schlüssel angeben, welchem Wert in der Wörterbuch-Entry sie jeweils zugeordnet werden.

Beispiele

Variablen übergeben

Um eine Variable an den Wörterbuch-Eintrag zu übergeben, müssen wir zwei Dinge tun: (1) dem 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 beziehen wir uns auf die Variable:

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

const Component = () => {
  const d = useTranslations();
  return <div>{d('greeting.hello', { 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.

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

export default dictionary;

Als Nächstes referenzieren wir die Variable:

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

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

Wie ist dieser Leitfaden?

DictionaryTranslationOptions