Types

DictionaryTranslationOptions

API-Referenz für den Typ DictionaryTranslationOptions

Übersicht

Der Typ DictionaryTranslationOptions wird verwendet, um Variablen an Wörterbucheinträge zu übergeben und ihr Anzeigeverhalten festzulegen. Er wird zusammen mit useDict() verwendet, um Variablen an Wörterbucheinträge zu übergeben.

Buildtime-Übersetzung: useDict()-Übersetzungen erfolgen zur Buildzeit; jedoch werden Variablen niemals übersetzt. Stattdessen werden sie mit Formatierung in die Übersetzung eingefügt. Achten Sie darauf, die Bereitstellungsanleitung hier zu befolgen.

Referenz

Parameter

PropTypeDefault
variablesOptions??
Record<string, Intl.NumberFormatOptions | Intl.DateTimeFormatOptions>
undefined
variables??
Record<string, any>
undefined

Beschreibung

PropBeschreibung
variablesEin Objekt, bei dem die Schlüssel angeben, wo jeder Wert im Wörterbucheintrag zugeordnet wird.
variablesOptionsEin Objekt, bei dem die Schlüssel die Variable identifizieren und die Werte das Verhalten der Variablen definieren. Siehe Intl.NumberFormatOptions und Intl.DateTimeFormatOptions für weitere Informationen.

Beispiele

Variablen übergeben

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

Zuerst fügen wir dem Dictionary-Eintrag eine Variable mit folgendem Syntax hinzu: {username}. username ist der Name der Variable.

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

export default dictionary;

Als Nächstes referenzieren wir die Variable:

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

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

Variable-Optionen hinzufügen

Mit Variable-Optionen kannst du anpassen, wie eine Variable dargestellt wird. Es wird die gleiche Syntax wie das variables-Objekt verwendet.

dictionary.ts
const dictionary = {
  account: {
    balance: 'Your account balance: {account-balance}!',
  },
};

export default dictionary;

Als Nächstes referenzieren wir die Variable:

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

const Component = () => {
  const d = useDict();
  return <div>
    { d(
      'account.balance',
      {
        variables: { "account-balance" : 1000000 },
        variableOptions: { "account-balance": { style: 'currency', currency: 'USD' } }
      }
    ) }
  </div>;
};

Hinweise

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

Nächste Schritte

Wie ist dieser Leitfaden?