Types

DictionaryTranslationOptions

API-Referenz für den Typ DictionaryTranslationOptions

Überblick

Der DictionaryTranslationOptions Typ wird verwendet, um Variablen an Wörterbucheinträge zu übergeben und ihr Render-Verhalten zu spezifizieren. Er wird mit useTranslations() und getTranslations() verwendet, um Variablen an Wörterbucheinträge zu übergeben.

Buildtime Translation: Variablen werden nicht mit useTranslations() und getTranslations() übersetzt, nur der ursprüngliche String. Siehe tx() für die Übersetzung von Strings mit dynamischem Inhalt.

Referenz

Parameter

PropTypeDefault
variables??
Record<string, any>
undefined

Beschreibung

PropBeschreibung
variablesEin Objekt, bei dem die Schlüssel identifizieren, wo jeder Wert im Wörterbucheintrag zugeordnet wird.

Beispiele

Variablen übergeben

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

Zuerst fügen wir eine Variable zum Wörterbucheintrag 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-next';

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

ICU-Nachrichtenformat verwenden

gt-next unterstützt das ICU-Nachrichtenformat, das es Ihnen ermöglicht, Ihre Variablen auch zu formatieren.

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>;
};

Notizen

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

Nächste Schritte

Wie ist dieser Leitfaden?