KI-Übersetzungshinweis

Dieses Dokument wurde von KI übersetzt. Für genaue Informationen lesen Sie bitte die englische Version.

ctx.i18n

Die i18n-Instanz des aktuellen Kontexts, die zum Lesen oder Wechseln von Sprachen verwendet wird. Verwenden Sie für Übersetzungen einheitlich ctx.t(); verwenden Sie nicht ctx.i18n.t.

Anwendungsbereiche

Alle RunJS-Ausführungsumgebungen können ctx.i18n verwenden (z. B. JSBlock, JSField, JSItem, JSColumn, Workflow, Verknüpfungsregeln usw.).

Typdefinition

interface i18n: {
  language: string;
  changeLanguage(lng: string): Promise<any>;
}

Gängige Eigenschaften

EigenschaftTypBeschreibung
languagestringDer aktuell aktive Sprachcode (z. B. zh-CN, en-US)

Gängige Methoden

changeLanguage(lng)

Wechselt die aktuelle Sprache.

ParameterTypBeschreibung
lngstringZiel-Sprachcode (z. B. 'en-US', 'zh-CN')

Rückgabewert: Promise<any>, wird aufgelöst (resolve), sobald der Sprachwechsel abgeschlossen ist.

Beispiele

Aktuelle Sprache lesen

const lang = ctx.i18n.language;
// 'zh-CN' | 'en-US' | ...
if (lang.startsWith('zh')) {
  ctx.render(ctx.t('Chinesische Benutzeroberfläche'));
} else {
  ctx.render(ctx.t('English UI'));
}

Sprache wechseln

// Zu Englisch wechseln
await ctx.i18n.changeLanguage('en-US');

// Zu Chinesisch wechseln
await ctx.i18n.changeLanguage('zh-CN');

Schaltfläche zum Sprachwechsel

const { Button } = ctx.libs.antd;
const isZh = ctx.i18n.language.startsWith('zh');
ctx.render(
  <Button onClick={async () => {
    await ctx.i18n.changeLanguage(isZh ? 'en-US' : 'zh-CN');
  }}>
    {ctx.t(isZh ? 'Zu Englisch wechseln' : 'Zu Chinesisch wechseln')}
  </Button>,
);

Hinweise

  • Übersetzungstexte: Verwenden Sie einheitlich ctx.t(), verwenden Sie nicht ctx.i18n.t.

Verwandte Themen

  • ctx.t(): Texte übersetzen, verwenden Sie einheitlich diese Methode.