GuidesModules

Language switcher

Connect the controlled language selector to your app's localization layer

  • Stable unknown
  • Release candidate since 1.16.1-rc.3
  • Development since 1.16.1-dev.2111+9796905

LanguageSwitcher renders language options and reports the selected value. It is a controlled component: your localization layer remains responsible for loading translations, changing the active locale, and persisting the preference.

import { LanguageSwitcher } from "@ovok/native/language-switcher";

function LanguageSettings({ language, changeLanguage }) {
  return (
    <LanguageSwitcher
      selectedLanguage={language}
      onLanguageChange={changeLanguage}
    >
      <LanguageSwitcher.Option value="en_US">
        <LanguageSwitcher.Option.RadioButton />
        <LanguageSwitcher.Option.Label>English</LanguageSwitcher.Option.Label>
      </LanguageSwitcher.Option>
      <LanguageSwitcher.Option value="de_DE">
        <LanguageSwitcher.Option.RadioButton />
        <LanguageSwitcher.Option.Label>Deutsch</LanguageSwitcher.Option.Label>
      </LanguageSwitcher.Option>
    </LanguageSwitcher>
  );
}

Use the same locale identifiers your translation system expects. Update the controlled language value after the localization change succeeds, and present loading or failure feedback in the surrounding screen. The SDK does not provide a language catalog or translation files.

References

API reference

Every export of @ovok/native/language-switcher, with signatures, props and types, is in the language-switcher API reference.

Last updated on

On this page