Module language_switcher

Expand description

LanguageSwitcher — a drop-in UI-language picker for settings screens.

A thin ComboBox preset that lists the application’s supported locales and switches the active locale on selection. Each entry is shown as its endonym — the language’s own name — followed by the BCP-47 tag, e.g. français (fr-FR), Deutsch (de-DE), العربية (ar-SA). Showing endonyms (not “French”, “German”, “Arabic”) means a speaker of each language can always find their own in the list.

Zero-config: drop it into a settings panel and it

self-populates from the installed I18nManager (teksilo_i18n::current_supported_locales()),
shows the active locale as the current selection (teksilo_i18n::current_locale()),
switches the app locale on selection via EventContext::set_locale, which the window manager fans out to every window (re-translating text and flipping layout direction for RTL locales like Arabic),
and keeps its selection in sync if the locale is changed elsewhere.

// In a settings panel's build():
VStack::new()
    .child(TextWidget::new(tr!(ui_language())).style(TextStyleRole::BodyBold))
    .child(LanguageSwitcher::new())

Endonyms come from ICU4X CLDR data via [teksilo_i18n::language_endonym]; an unknown tag falls back to the raw BCP-47 tag. When no I18nManager is configured the switcher renders an empty, placeholder ComboBox.

Structs§

LanguageSwitcher: A UI-language picker built on ComboBox. See the module docs.