createTranslator

Build a typed translator from a resolved translation map

createTranslator wraps the flat map returned by getI18nTranslations and returns a typed translator. Providers call this internally after merging registry, lazy-loaded built-in packs, browser-translated fallback copy, and provider layers. Use it directly for custom UI outside built-in controls.

import { createTranslator, getI18nTranslations } from '@videojs/html/i18n';

const t = createTranslator(getI18nTranslations('fr'), 'fr');
t('buttons.play', { default: 'Play' });
t('seek.forward', { seconds: 5, default: 'Seek forward {seconds} seconds' });

import { createTranslator, getI18nTranslations } from '@videojs/react/i18n';

const t = createTranslator(getI18nTranslations('fr'), 'fr');
t('buttons.play', { default: 'Play' });
t('seek.forward', { seconds: 5, default: 'Seek forward {seconds} seconds' });

API Reference

Parameters

Parameter	Type	Default
`translations*`	`object & Record<string, string \| unde...`	`—`
Description Merged translation map for the active locale. Type `object & Record<string, string \| undefined>`
`locale*`	`string & object \| 'ar' \| 'az' \| 'bs' ...`	`—`
Description BCP 47 tag associated with the map (reserved for future locale-aware behavior). Type `string & object \| 'ar' \| 'az' \| 'bs' \| 'bg' \| 'bn' \| 'ca' \| 'cs' \| 'cy' \| 'da' \| 'de' \| 'el' \| 'es' \| 'et' \| 'eu' \| 'fa' \| 'fi' \| 'fr' \| 'gd' \| 'gl' \| 'he' \| 'hi' \| 'hr' \| 'hu' \| 'id' \| 'it' \| 'ja' \| 'ko' \| 'lv' \| 'mr' \| 'nb' \| 'nl' \| 'nn' \| 'ne' \| 'oc' \| 'pl' \| 'pt-BR' \| 'pt-PT' \| 'ro' \| 'ru' \| 'sk' \| 'sl' \| 'sr' \| 'sv' \| 'te' \| 'th' \| 'tr' \| 'uk' \| 'vi' \| 'zh-CN' \| 'zh-TW'`

Return Value

Translator