Skip to main content

Locales

Overview​

Upmade comes with built-in support for multiple languages and allows you to override or extend the default translations with custom locales.

Take a look at the Localization Terms to see all available localization keys.

Switching the Locale​

To change the active interface language, bind the [locale] property on <upmade-editor> or call the asynchronous setLocale() method. The editor instantly updates all UI controls and context menus without requiring a page reload.

Listening for Locale Changes​

Listen for the localeChange event to react when the active locale changes, for example to sync a UI status label, persist the selected language, or update a custom settings panel.

Registering Custom Locales​

You can add support for additional languages (such as Spanish 'es') or override individual term keys (such as menu.copy or settings.dialogTitle) by providing an UpmadeLocale definition. Pass custom locales to the [locales] binding or register them dynamically using registerLocales().

API Details​

For the full list of related APIs, see the following reference sections.

Support us

Upmade is an MIT-licensed open source project. If you like the idea of a framework-agnostic infinite canvas library and want to support our work, leave us a star or consider becoming a sponsor.