#ctx.t()

i18n helper for translating strings in RunJS, based on the current context language. Suitable for inline text such as buttons, titles, and hints.

#Type definition

t(key: string, options?: Record<string, any>): string

#Parameters

#Return value

• Returns translated string. If no translation exists and no defaultValue is provided, it may return the key itself or the interpolated string.

#Notes

• i18next-style interpolation is supported: use {{var}} in the key and pass variables in options.
• Language is determined by current context (user language, app locale).
• When the localization plugin is enabled, ctx.t strings are extracted for centralized translation management.

#Examples

#Simple keys

ctx.t('Submit');
ctx.t('No data');

#With interpolation

const text = ctx.t('Hello {{name}}', { name: ctx.user?.nickname || 'Guest' });
ctx.render(`<div>${text}</div>`);

ctx.message.success(ctx.t('Processed {{count}} rows', { count: rows.length }));

#Dynamic time text

if (minutes < 60) return ctx.t('{{count}} minutes ago', { count: minutes });
if (hours < 24) return ctx.t('{{count}} hours ago', { count: hours });

#Namespaces (ns)

When translation resources are split by namespace, use ns to specify which namespace to search:

// Read from a specific namespace
ctx.t('Submit', { ns: 'myModule' });

// Search multiple namespaces in order (myModule, then common)
ctx.t('Save', { ns: ['myModule', 'common'] });

// Interpolation with namespace
ctx.t('Hello {{name}}', { name: 'Guest', ns: 'myModule' });