Translations
Default behaviour
The hanko-elements
package includes English translations by default and the lang
attribute can be omitted.
Script
Markup
Installing Additional Translations
Translations are currently available for the following languages
- ”de” - German
- ”en” - English
- ”fr” - French
You can import them individually
Or import all translations at once
After importing, provide the translations through the register()
function
You can now set the lang
attribute of the element to the desired language
Modifying Translations
You can modify existing translations as follows
Adding New Translations
If you need to create a new translation, pass an object that implements (or partially implements) the Translation
interface.
Script
Markup
Using External Files
For languages provided via the element’s lang attribute, or via the fallback language option, that are not included in the object passed to the translations
option, the component will fetch a JSON file from the location specified by the translationsLocation
option. For example, if “en” is missing due to an empty object being passed, as shown in the example below, the component will fetch a file named /i18n/en.json
.
Script
Markup
Fallback Language
The fallbackLanguage
option is used to specify a fallback language for the web components when translations are missing or incomplete for a particular language. By setting the fallbackLanguage
option to a valid language string like “en” or “de”, the missing translation strings will be automatically retrieved from the specified fallback language. When the translation for the specified fallbackLanguage
is not available in the translations
option, the web components will attempt to fetch it from an external file.
Script
Markup
Was this page helpful?